権利を取得する
GET /accounts/{account_id}/core/v1/entitlements/{entitlement_id}
JSON レスポンスボディに格納されている Entitlement API リソースを返します。
パラメータ
| Name | を入力します | 入力 | 必須 | 説明 |
|---|---|---|---|---|
account_id |
string |
path(パス) |
True |
包含するアカウントリソースのID
|
entitlement_id |
string |
path(パス) |
True |
リストする権利コレクションのID |
応答
Status: 200, Returns the stored Entitlement API resource in the JSON response body.
| Name | を入力します | 必須 | 説明 |
|---|---|---|---|
を入力します |
string |
True |
リソースのメディアタイプ。定義された値は次のとおりです:
|
バージョン |
string |
True |
リソースのバージョン。定義された値は次のとおりです:
|
ID |
string |
True |
リソースのグローバル一意識別子。定義された値は次のとおりです:
|
割り当て |
string |
False |
権限が割り当てられているオブジェクトのIDを含むJSON文字列。権限が割り当てられている場合にのみ存在します。文字列の内容はスキーマによって検証されません。 |
製品 |
string |
False |
ライセンスまたはサブスクリプションから抽出された製品文字列を含むJSON文字列。文字列の内容はスキーマによって検証されません。 |
productVersion |
string |
False |
ライセンスまたはサブスクリプションから抽出されたバージョン文字列を含むJSON文字列。文字列の内容はスキーマによって検証されません。 |
entitlementType |
string |
True |
エンタイトルメントのタイプを含むJSON文字列。これはライセンスまたはサブスクリプションから抽出されます。文字列の内容はスキーマによって検証されません。 |
entitlementValue |
string |
True |
権限に関連付けられた容量を含むJSON文字列。文字列の内容はスキーマによって検証されません。 |
entitlementConsumption |
string |
False |
エンタイトルメントに関連付けられた容量のうち、現在使用されている容量を示すJSON文字列。文字列の内容はスキーマによって検証されません。 |
sourceLicense |
string |
False |
ライセンスの取得元となるライセンスオブジェクトIDを含むJSON文字列。定義された値は次のとおりです:
|
sourceSubscription |
string |
False |
エンタイトルメントのソースとなるサブスクリプションオブジェクトのIDを含むJSON文字列。定義された値は次のとおりです:
|
validFromTimestamp |
string |
False |
権利が有効になる日時を示すタイムスタンプを含むJSON文字列。定義された値は次のとおりです:
|
validUntilTimestamp |
string |
False |
権利が無効になった日時を示すタイムスタンプを含むJSON文字列。定義された値は次のとおりです:
|
メタデータ |
True |
リソースに関連付けられた、クライアントおよびサービス指定のメタデータ。定義された値は次のとおりです:
|
回答例
{
"type": "application/astra-entitlement",
"version": "1.0",
"id": "8bdafc19-bde6-5f45-9808-4893c845c9f5",
"product": "Astra SDS",
"productVersion": "1.0",
"entitlementType": "capacity",
"entitlementValue": "2",
"entitlementConsumption": "1",
"sourceLicense": "c8aa757a-5318-489f-8134-a2a1a6956a3e",
"validFromTimestamp": "2020-08-06T00:00:00.000000Z",
"validUntilTimestamp": "2021-08-06T00:00:00.000000Z",
"metadata": {
"labels": [],
"creationTimestamp": "2022-10-06T20:58:16.305662Z",
"modificationTimestamp": "2022-10-06T20:58:16.305662Z",
"createdBy": "8f84cf09-8036-51e4-b579-bd30cb07b269"
}
}
応答
Status: 401, Unauthorized
| Name | を入力します | 必須 | 説明 |
|---|---|---|---|
を入力します |
string |
True |
|
タイトル |
string |
True |
|
詳細 |
string |
True |
|
ステータス |
string |
True |
|
correlationID |
string |
False |
回答例
{
"type": "https://astra.netapp.io/problems/3",
"title": "Missing bearer token",
"detail": "The request is missing the required bearer token.",
"status": "401"
}
応答
Status: 400, Bad request
| Name | を入力します | 必須 | 説明 |
|---|---|---|---|
を入力します |
string |
True |
|
タイトル |
string |
True |
|
詳細 |
string |
True |
|
ステータス |
string |
True |
|
correlationID |
string |
False |
|
invalidParams |
配列["invalidParams"] |
False |
無効なクエリパラメータのリスト |
回答例
{
"type": "https://astra.netapp.io/problems/5",
"title": "Invalid query parameters",
"detail": "The supplied query parameters are invalid.",
"status": "400"
}
応答
Status: 403, Forbidden
| Name | を入力します | 必須 | 説明 |
|---|---|---|---|
を入力します |
string |
True |
|
タイトル |
string |
True |
|
詳細 |
string |
True |
|
ステータス |
string |
True |
|
correlationID |
string |
False |
回答例
{
"type": "https://astra.netapp.io/problems/11",
"title": "Operation not permitted",
"detail": "The requested operation isn't permitted.",
"status": "403"
}
エラー
Status: 404, Not found
| Name | を入力します | 必須 | 説明 |
|---|---|---|---|
を入力します |
string |
True |
|
タイトル |
string |
True |
|
詳細 |
string |
True |
|
ステータス |
string |
True |
|
correlationID |
string |
False |
エラー応答の例
{
"type": "https://astra.netapp.io/problems/2",
"title": "Collection not found",
"detail": "The collection specified in the request URI wasn't found.",
"status": "404"
}
用語の意味
定義を参照
type_astra_label
| Name | を入力します | 必須 | 説明 |
|---|---|---|---|
名前 |
string |
True |
|
Value |
string |
True |
type_astra_metadata
リソースに関連付けられた、クライアントおよびサービス指定のメタデータ。定義された値は次のとおりです:
-
Astraメタデータスキーマに準拠
| Name | を入力します | 必須 | 説明 |
|---|---|---|---|
ラベル |
True |
||
作成タイムスタンプ |
string |
True |
|
modificationTimestamp |
string |
True |
|
作成者 |
string |
True |
|
modifiedBy |
string |
False |
invalidParams
| Name | を入力します | 必須 | 説明 |
|---|---|---|---|
名前 |
string |
True |
無効なクエリパラメータの名前 |
理由 |
string |
True |
クエリパラメータが無効な理由 |