使用 Active IQ Unified Manager 中的 API 修改存储工作负载
修改存储工作负载包括更新缺少参数的 LUN 或文件共享,或更改现有参数。
此工作流以更新 LUN 和文件共享的性能服务级别为例。
|
|
工作流假定 LUN 或文件共享已使用性能服务级别进行调配。 |
修改文件共享
修改文件共享时,可以更新以下参数:
-
容量或大小。
-
在线或离线设置。
-
存储效率策略。
-
性能服务级别。
-
访问控制列表(ACL)设置。
-
导出策略设置。您还可以删除导出策略参数并还原文件共享上的默认(空)导出策略规则。
|
|
在单个 API 运行期间,您只能更新一个参数。 |
此过程描述向文件共享添加性能服务级别。您可以使用相同的过程来更新任何其他文件共享属性。
-
获取要更新的文件共享的 CIFS 共享或 NFS 文件共享密钥。此 API 查询数据中心上的所有文件共享。如果您已经知道文件共享密钥,请跳过此步骤。
类别 HTTP 谓词 路径 storage-provider
GET
/storage-provider/file-shares -
使用获取的文件共享密钥运行以下 API,查看文件共享的详细信息。
类别 HTTP 谓词 路径 storage-provider
GET
/storage-provider/file-shares/{key}在输出中查看文件共享的详细信息。
"assigned_performance_service_level": { "key": null, "name": "Unassigned", "peak_iops": null, "expected_iops": null, "_links": {} }, -
获取要在此文件共享上分配的性能服务级别的密钥。当前未为其分配任何策略。
类别 HTTP 谓词 路径 性能服务级别
GET
/storage-provider/performance-service-levels您可以通过将 `system_defined`输入参数设置为 `true`来检索系统定义的性能服务级别的详细信息。从输出中,获取要应用于文件共享的性能服务级别的键。
-
对文件共享应用性能服务级别。
类别 HTTP 谓词 路径 存储提供商
PATCH
/storage-provider/file-shares/{key}在输入中,必须仅指定要更新的参数以及文件共享键。在本例中,它是性能服务级别的键。
示例 cURL
curl -X POST "https://<hostname>/api/storage-provider/file-shares"`-H "accept: application/json" -H "Authorization: Basic <Base64EncodedCredentials>" -d "{ \"performance_service_level\": { \"key\": \"1251e51b-069f-11ea-980d-fa163e82bbf2\" }, }"JSON 输出显示一个作业对象,您可以使用该对象来验证归属节点和配对节点上的访问端点是否已成功创建。
-
使用输出中显示的作业对象键,验证是否已将性能服务级别添加到文件共享。
类别 HTTP 谓词 路径 管理服务器
GET
/management-server/jobs/{key}如果按作业对象的 ID 查询,您会看到文件共享是否成功更新。如果发生故障,请排除故障并再次运行 API。成功创建后,查询文件共享以查看修改的对象:
类别 HTTP 谓词 路径 storage-provider
GET
/storage-provider/file-shares/{key}在输出中查看文件共享的详细信息。
"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" } }
更新 LUN
更新 LUN 时,可以修改以下参数:
-
容量或大小
-
在线或离线设置
-
存储效率策略
-
性能服务级别
-
LUN 映射
|
|
在单个 API 运行期间,您只能更新一个参数。 |
此过程描述向 LUN 添加性能服务级别。您可以使用相同的过程来更新任何其他 LUN 属性。
-
获取要更新的 LUN 的 LUN 密钥。此 API 返回数据中心中所有 LUN 的详细信息。如果您已经知道 LUN 密钥,请跳过此步骤。
类别 HTTP 谓词 路径 存储提供商
GET
/storage-provider/luns -
使用您获取的 LUN 密钥运行以下 API ,以查看 LUN 的详细信息。
类别 HTTP 谓词 路径 存储提供商
GET
/storage-provider/luns/{key}在输出中查看 LUN 的详细信息。您可以看到未向此 LUN 分配任何性能服务级别。
JSON 输出示例
"assigned_performance_service_level": { "key": null, "name": "Unassigned", "peak_iops": null, "expected_iops": null, "_links": {} }, -
获取要分配给 LUN 的性能服务级别的键。
类别 HTTP 谓词 路径 性能服务级别
GET
/storage-provider/performance-service-levels您可以通过将 `system_defined`输入参数设置为 `true`来检索系统定义的性能服务级别的详细信息。从输出中,获取要在 LUN 上应用的性能服务级别的键。
-
在 LUN 上应用性能服务级别。
类别 HTTP 谓词 路径 存储提供商
PATCH
/storage-provider/lun/{key}在输入中,您必须仅指定要更新的参数以及 LUN 键。在本例中,它是性能服务级别的键。
示例 cURL
curl -X PATCH "https://<hostname>/api/storage-provider/luns/7d5a59b3-953a-11e8-8857-00a098dcc959" -H "accept: application/json" -H "Content-Type: application/json" H "Authorization: Basic <Base64EncodedCredentials>" -d "{ \"performance_service_level\": { \"key\": \"1251e51b-069f-11ea-980d-fa163e82bbf2\" }"JSON 输出将显示可用于验证已更新 LUN 的作业对象键。
-
使用您获取的 LUN 密钥运行以下 API ,以查看 LUN 的详细信息。
类别 HTTP 谓词 路径 存储提供商
GET
/storage-provider/luns/{key}在输出中查看 LUN 的详细信息。您可以看到性能服务级别已分配给此 LUN。
JSON 输出示例
"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" }