Active IQ Unified Manager API를 사용하여 CIFS 및 NFS 파일 공유를 프로비저닝합니다.
변경 제안
PDF
Active IQ Unified Manager의 일부로 제공되는 프로비저닝 API를 사용하여 스토리지 가상 머신(SVM)에 CIFS 공유 및 NFS 파일 공유를 프로비저닝할 수 있습니다. 이 프로비저닝 워크플로에서는 파일 공유를 생성하기 전에 SVM 키, 성능 서비스 수준 및 스토리지 효율성 정책을 가져오는 단계를 자세히 설명합니다.
다음 다이어그램은 파일 공유 프로비저닝 워크플로의 각 단계를 보여줍니다. 여기에는 CIFS 공유와 NFS 파일 공유 프로비저닝이 모두 포함됩니다.
|
다음 사항을 확인하십시오.
|
-
CIFS 공유를 생성하려는 SVM에 데이터 LIF 또는 액세스 엔드포인트가 사용 가능한지 확인합니다. SVM에서 사용 가능한 액세스 엔드포인트 목록을 가져옵니다:
범주 HTTP 동사 경로 storage-provider
GET
/storage-provider/access-endpoints/storage-provider/access-endpoints/{key}샘플 cURL
curl -X GET "https://<hostname>/api/storage-provider/access-endpoints?resource.key=7d5a59b3-953a-11e8-8857-00a098dcc959" -H "accept: application/json" -H "Authorization: Basic <Base64EncodedCredentials>"
-
액세스 엔드포인트가 목록에 있으면 액세스 엔드포인트 키를 가져오고, 없으면 액세스 엔드포인트를 생성하십시오.
CIFS 프로토콜이 활성화된 액세스 엔드포인트를 생성해야 합니다. CIFS 프로토콜이 활성화된 액세스 엔드포인트를 생성하지 않으면 CIFS 공유 프로비저닝이 실패합니다.
범주 HTTP 동사 경로 storage-provider
POST
/storage-provider/access-endpoints샘플 cURL
입력 매개변수로 생성하려는 액세스 엔드포인트의 세부 정보를 입력해야 합니다.
curl -X POST "https://<hostname>/api/storage-provider/access-endpoints" -H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Basic <Base64EncodedCredentials>" { \"data_protocols\": \"nfs\", \"fileshare\": { \"key\": \"cbd1757b-0580-11e8-bd9d-00a098d39e12:type=volume,uuid=f3063d27-2c71-44e5-9a69-a3927c19c8fc\" }, \"gateway\": \"10.132.72.12\", \"ip\": { \"address\": \"10.162.83.26\", \"ha_address\": \"10.142.83.26\", \"netmask\": \"255.255.0.0\" }, \"lun\": { \"key\": \"cbd1757b-0580-11e8-bd9d-00a098d39e12:type=lun,uuid=d208cc7d-80a3-4755-93d4-5db2c38f55a6\" }, \"mtu\": 15000, \"name\": \"aep1\", \"svm\": { \"key\": \"cbd1757b-0580-11e8-bd9d-00a178d39e12:type=vserver,uuid=1d1c3198-fc57-11e8-99ca-00a098d38e12\" }, \"vlan\": 10}"JSON 출력에는 생성한 액세스 엔드포인트를 확인하는 데 사용할 수 있는 Job 오브젝트 키가 표시됩니다.
-
액세스 엔드포인트를 확인하십시오:
범주 HTTP 동사 경로 management-server
GET
/management-server/jobs/{key} -
CIFS 공유 또는 NFS 파일 공유를 생성해야 하는지 결정하십시오. CIFS 공유를 생성하려면 다음 하위 단계를 따르십시오.
-
SVM에 CIFS 서버가 구성되어 있는지, 즉 SVM에 Active Directory 매핑이 생성되었는지 확인하십시오.
범주 HTTP 동사 경로 storage-provider
GET
/storage-provider/active-directories-mappings -
Active Directory 매핑이 이미 생성된 경우 키를 가져오고, 그렇지 않으면 SVM에 Active Directory 매핑을 생성합니다.
범주 HTTP 동사 경로 storage-provider
POST
/storage-provider/active-directories-mappings샘플 cURL
Active Directory 매핑을 생성하기 위한 세부 정보를 입력 매개변수로 입력해야 합니다.
curl -X POST "https://<hostname>/api/storage-provider/active-directories-mappings" -H "accept: application/json" -H "Content-Type: application/json" -H "Authorization: Basic <Base64EncodedCredentials>" { \"_links\": {}, \"dns\": \"10.000.000.000\", \"domain\": \"example.com\", \"password\": \"string\", \"svm\": { \"key\": \"9f4ddea-e395-11e9-b660-005056a71be9:type=vserver,uuid=191a554a-f0ce-11e9-b660-005056a71be9\" }, \"username\": \"string\"}"+ 이는 동기식 호출이며 출력에서 Active Directory 매핑 생성을 확인할 수 있습니다. 오류가 발생할 경우, 문제를 해결하고 요청을 다시 실행할 수 있도록 오류 메시지가 표시됩니다.
-
-
클러스터에서 SVM 확인하기 워크플로 항목에 설명된 대로 CIFS 공유 또는 NFS 파일 공유를 생성하려는 SVM의 SVM 키를 가져오십시오.
-
다음 API를 실행하고 응답에서 키를 가져와 성능 서비스 수준에 대한 키를 얻으십시오.
범주 HTTP 동사 경로 storage-provider
GET
/storage-provider/performance-service-levels
`system_defined` 입력 매개변수를 `true`(으)로 설정하여 시스템에서 정의한 성능 서비스 수준의 세부 정보를 검색할 수 있습니다. 출력에서 파일 공유에 적용하려는 성능 서비스 수준의 키를 가져오십시오.
-
선택적으로, 다음 API를 실행하고 응답에서 키를 검색하여 파일 공유에 적용하려는 스토리지 효율성 정책의 스토리지 효율성 정책 키를 가져옵니다.
범주 HTTP 동사 경로 storage-provider
GET
/storage-provider/storage-efficiency-policies -
파일 공유를 생성합니다. 액세스 제어 목록과 내보내기 정책을 지정하여 CIFS와 NFS를 모두 지원하는 파일 공유를 생성할 수 있습니다. 다음 하위 단계에서는 볼륨에서 프로토콜 중 하나만 지원하는 파일 공유를 생성하려는 경우에 대한 정보를 제공합니다. NFS 공유를 생성한 후 액세스 제어 목록을 포함하도록 NFS 파일 공유를 업데이트할 수도 있습니다. 자세한 내용은 스토리지 워크로드 수정 항목을 참조하십시오.
-
CIFS 공유만 생성하려면 액세스 제어 목록(ACL)에 대한 정보를 수집하십시오. CIFS 공유를 생성하려면 다음 입력 매개변수에 유효한 값을 제공하십시오. 할당하는 각 사용자 그룹에 대해 CIFS/SMB 공유가 프로비저닝될 때 ACL이 생성됩니다. ACL 및 Active Directory 매핑에 대해 입력한 값을 기반으로, CIFS 공유가 생성될 때 액세스 제어 및 매핑이 결정됩니다.
샘플 값을 포함한 cURL 명령어
{ "access_control": { "acl": [ { "permission": "read", "user_or_group": "everyone" } ], "active_directory_mapping": { "key": "3b648c1b-d965-03b7-20da-61b791a6263c" }, -
NFS 파일 공유만 생성하려면 내보내기 정책에 대한 정보를 수집하십시오. NFS 파일 공유를 생성하려면 다음 입력 매개변수에 유효한 값을 제공하십시오. 입력한 값에 따라 내보내기 정책이 NFS 파일 공유 생성 시 연결됩니다.
NFS 공유를 프로비저닝하는 동안 필요한 모든 값을 제공하여 내보내기 정책을 생성하거나 내보내기 정책 키를 제공하여 기존 내보내기 정책을 재사용할 수 있습니다. 스토리지 VM에 대해 내보내기 정책을 재사용하려면 내보내기 정책 키를 추가해야 합니다. 키를 모르는 경우
/datacenter/protocols/nfs/export-policiesAPI를 사용하여 내보내기 정책 키를 가져올 수 있습니다. 새 정책을 생성하려면 다음 예시와 같이 규칙을 입력해야 합니다. 입력된 규칙에 대해 API는 호스트, 스토리지 VM 및 규칙을 일치시켜 기존 내보내기 정책을 검색합니다. 기존 내보내기 정책이 있으면 해당 정책이 사용됩니다. 그렇지 않으면 새 내보내기 정책이 생성됩니다.샘플 값을 포함한 cURL 명령어
"export_policy": { "key": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=export_policy,uuid=1460288880641", "name_tag": "ExportPolicyNameTag", "rules": [ { "clients": [ { "match": "0.0.0.0/0" }
액세스 제어 목록과 내보내기 정책을 구성한 후 CIFS 및 NFS 파일 공유 모두에 대한 필수 입력 매개변수에 유효한 값을 제공하십시오:
-
|
|
스토리지 효율성 정책은 파일 공유를 생성할 때 사용할 수 있는 선택적 매개변수입니다. |
| 범주 | HTTP 동사 | 경로 |
|---|---|---|
storage-provider |
POST |
|
JSON 출력에는 생성한 파일 공유를 확인하는 데 사용할 수 있는 Job 오브젝트 키가 표시됩니다. . 작업 조회 시 반환된 Job 오브젝트 키를 사용하여 파일 공유 생성을 확인합니다:
| 범주 | HTTP 동사 | 경로 |
|---|---|---|
management-server |
GET |
|
응답의 마지막 부분에 생성된 파일 공유의 키가 표시됩니다.
],
"job_results": [
{
"name": "fileshareKey",
"value": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=volume,uuid=e581c23a-1037-11ea-ac5a-00a098dcc6b6"
}
],
"_links": {
"self": {
"href": "/api/management-server/jobs/06a6148bf9e862df:-2611856e:16e8d47e722:-7f87"
}
}
}
-
반환된 키를 사용하여 다음 API를 실행해 파일 공유 생성을 확인하십시오:
범주 HTTP 동사 경로 storage-provider
GET
/storage-provider/file-shares/{key}샘플 JSON 출력
`/storage-provider/file-shares`의 POST 메서드가 내부적으로 각 기능에 필요한 모든 API를 호출하고 오브젝트를 생성하는 것을 볼 수 있습니다. 예를 들어, 파일 공유에 성능 서비스 수준을 할당하기 위해 `/storage-provider/performance-service-levels/` API를 호출합니다.
{ "key": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=volume,uuid=e581c23a-1037-11ea-ac5a-00a098dcc6b6", "name": "FileShare_377", "cluster": { "uuid": "7d5a59b3-953a-11e8-8857-00a098dcc959", "key": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=cluster,uuid=7d5a59b3-953a-11e8-8857-00a098dcc959", "name": "AFFA300-206-68-70-72-74", "_links": { "self": { "href": "/api/datacenter/cluster/clusters/7d5a59b3-953a-11e8-8857-00a098dcc959:type=cluster,uuid=7d5a59b3-953a-11e8-8857-00a098dcc959" } } }, "svm": { "uuid": "b106d7b1-51e9-11e9-8857-00a098dcc959", "key": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=vserver,uuid=b106d7b1-51e9-11e9-8857-00a098dcc959", "name": "RRT_ritu_vs1", "_links": { "self": { "href": "/api/datacenter/svm/svms/7d5a59b3-953a-11e8-8857-00a098dcc959:type=vserver,uuid=b106d7b1-51e9-11e9-8857-00a098dcc959" } } }, "assigned_performance_service_level": { "key": "1251e51b-069f-11ea-980d-fa163e82bbf2", "name": "Value", "peak_iops": 75, "expected_iops": 75, "_links": { "self": { "href": "/api/storage-provider/performance-service-levels/1251e51b-069f-11ea-980d-fa163e82bbf2" } } }, "recommended_performance_service_level": { "key": null, "name": "Idle", "peak_iops": null, "expected_iops": null, "_links": {} }, "space": { "size": 104857600 }, "assigned_storage_efficiency_policy": { "key": null, "name": "Unassigned", "_links": {} }, "access_control": { "acl": [ { "user_or_group": "everyone", "permission": "read" } ], "export_policy": { "id": 1460288880641, "key": "7d5a59b3-953a-11e8-8857-00a098dcc959:type=export_policy,uuid=1460288880641", "name": "default", "rules": [ { "anonymous_user": "65534", "clients": [ { "match": "0.0.0.0/0" } ], "index": 1, "protocols": [ "nfs3", "nfs4" ], "ro_rule": [ "sys" ], "rw_rule": [ "sys" ], "superuser": [ "none" ] }, { "anonymous_user": "65534", "clients": [ { "match": "0.0.0.0/0" } ], "index": 2, "protocols": [ "cifs" ], "ro_rule": [ "ntlm" ], "rw_rule": [ "ntlm" ], "superuser": [ "none" ] } ], "_links": { "self": { "href": "/api/datacenter/protocols/nfs/export-policies/7d5a59b3-953a-11e8-8857-00a098dcc959:type=export_policy,uuid=1460288880641" } } } }, "_links": { "self": { "href": "/api/storage-provider/file-shares/7d5a59b3-953a-11e8-8857-00a098dcc959:type=volume,uuid=e581c23a-1037-11ea-ac5a-00a098dcc6b6" } } }