Skip to main content
24.02
日本語は機械翻訳による参考訳です。内容に矛盾や不一致があった場合には、英語の内容が優先されます。

ライセンスを変更する

PDF

PUT /accounts/{account_id}/core/v1/licenses/{license_id}

保存されているリソース全体を、指定されたJSONリクエストボディに置き換えますが、ユーザーが変更できないキー値は保持します。

副作用

  • ライセンス権限は、Entitlement APIを通じて確認できるライセンス権限を追加または統合するために再計算されます。

パラメータ

Name を入力します 入力 必須 説明

account_id

string

path（パス）

True

包含するアカウントリソースのID

  • 例：{{.Account}}

license_id

string

path（パス）

True

リストするライセンスコレクションのID

要求の本文

保存されているリソース全体を、指定されたJSONリクエストボディに置き換えますが、ユーザーが変更できないキー値は保持します。

副作用

  • ライセンス権限は、Entitlement APIを通じて確認できるライセンス権限を追加または統合するために再計算されます。

Name を入力します 必須 説明

を入力します

string

True

リソースのメディアタイプ。定義された値は次のとおりです：

  • "application/astra-license"

バージョン

string

True

リソースのバージョン。定義された値は次のとおりです：

  • "1.0"

ID

string

False

リソースのグローバル一意識別子。定義された値は次のとおりです：

  • UUIDv4スキーマに準拠

割り当て

string

False

ライセンスが何に割り当てられているかを示すIDを含むJSON文字列。ライセンスが割り当てられている場合にのみ存在します。Astra Control Centerライセンスの場合、このフィールドにはアカウントIDを入力する必要があり、POST URIで指定されたアカウントIDと一致している必要があります。定義値は次のとおりです：

  • Astra識別子スキーマに準拠

hostID

string

False

ライセンスが紐付けられているホスト識別子を含むJSON文字列。ライセンスがホストロックされている場合にのみ表示されます。定義値は次のとおりです：

  • 最小長さ：1

  • 最大長さ：63

deviceCredentialID

string

False

Credential APIに関連付けられたdeviceCredentialの識別子を含むJSON文字列。Astra Data Storeライセンスにのみ存在します。定義された値は次のとおりです：

  • Astra識別子スキーマに準拠

isEvaluation

string

False

ライセンスが評価版ライセンスであるかどうかを示すJSON文字列。定義された値は次のとおりです：

  • "true"

  • "false"

licenseProtocol

string

False

ライセンスから抽出されたライセンスプロトコルを含むJSON文字列。定義値は次のとおりです：

  • スキーマで検証されていない文字列の内容

licenseText

string

False

NetAppライセンスシステムから取得したライセンスJSONのbase64エンコード表現を含むJSON文字列。署名検証を可能にするため、これは元のバイトレベルの順序で提供されなければなりません。定義値は次のとおりです：

  • base64 Encoded Data Schemaに準拠

validFromTimestamp

string

False

ライセンスが有効になる日時を示すタイムスタンプを含むJSON文字列。定義値は次のとおりです：

  • ISO-8601 Date Time Schemaに準拠

validUntilTimestamp

string

False

ライセンスが無効になった日時を示すタイムスタンプを含むJSON文字列。定義値は次のとおりです：

  • ISO-8601 Date Time Schemaに準拠

製品

string

False

ライセンスから抽出された製品文字列を含むJSON文字列。定義値は次のとおりです：

  • スキーマで検証されていない文字列の内容

productVersion

string

False

ライセンスから抽出されたバージョン文字列を含むJSON文字列。定義されている値は次のとおりです：

  • スキーマで検証されていない文字列の内容

productSN

string

False

ライセンスから抽出されたシリアル番号文字列を含むJSON文字列。定義された値は次のとおりです：

  • スキーマで検証されていない文字列の内容

機能

string

False

ライセンスから抽出されたパッケージ値を含むJSON文字列。定義された値は次のとおりです：

  • スキーマで検証されていない文字列の内容

capacity

string

False

ライセンスから抽出された容量を含むJSON文字列。

capacity2を使用したチャンク アップロード署名要求がサポートされるようになりました。

string

False

ライセンスから抽出されたセカンダリ容量を含むJSON文字列。

アドオン

配列["アドオン"]

False

ライセンスに含まれるアドオンのリストを含むJSONオブジェクトのJSON配列。アドオンとは、将来発生する可能性のある特定の日付におけるライセンスの変更のことです。

メタデータ

"type_astra_metadata_update"

False

リソースに関連付けられた、クライアントおよびサービス指定のメタデータ。定義された値は次のとおりです：

  • Astra メタデータスキーマに準拠します。作成時に指定しない場合、ラベルのないメタデータオブジェクトが作成されます。更新時に指定されていない場合、メタデータオブジェクトのラベル、creationTimestamp および createdBy は、変更なしで保持されます。
リクエスト例 
{
  "type": "application/astra-license",
  "version": "1.0",
  "allocation": "4185d09b-6687-4801-a832-c005a9d94f41",
  "licenseText": "ewogICAic3RhdHVzUmVzcCI6ewogMTYwNzAwIgp9"
}

応答

Status: 204, Indicates if the license resource was updated.

応答

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
回答例 
{
  "type": "https://astra.netapp.io/problems/5",
  "title": "Invalid query parameters",
  "detail": "The supplied query parameters are invalid.",
  "status": "400"
}

応答

Status: 409, Conflict
Name を入力します 必須 説明

を入力します

string

True

タイトル

string

True

詳細

string

True

ステータス

string

True

correlationID

string

False

invalidFields

配列["invalidFields"]

False

無効なリクエストボディフィールドのリスト
回答例 
{
  "type": "https://astra.netapp.io/problems/10",
  "title": "JSON resource conflict",
  "detail": "The request body JSON contains a field that conflicts with an idempotent value.",
  "status": "409"
}

応答

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/1",
  "title": "Resource not found",
  "detail": "The resource specified in the request URI wasn't found.",
  "status": "404"
}

用語の意味

定義を参照

アドオン

Name を入力します 必須 説明

startDate

string

False

このアドオンが有効になる日時を示すタイムスタンプを含むJSON文字列。定義された値は次のとおりです：

  • ISO-8601 Date Time Schemaに準拠

endDate

string

False

このアドオンが無効になった日時を示すタイムスタンプを含むJSON文字列。定義された値は次のとおりです：

  • ISO-8601 Date Time Schemaに準拠

機能

string

False

このアドオンに関連付けられた機能のリストを含むJSON文字列。定義された値は次のとおりです：

  • 文字列の内容がスキーマによって検証されていません。

capacity

string

False

アドオンから抽出された容量を含むJSON文字列。定義された値は次のとおりです：

  • スキーマで検証されていない文字列の内容

licenseProtocol

string

False

このアドオンに関連付けられたライセンスプロトコルを含むJSON文字列。定義された値は次のとおりです：

  • スキーマで検証されていない文字列の内容

type_astra_label

Name を入力します 必須 説明

名前

string

True

Value

string

True

type_astra_metadata_update

リソースに関連付けられた、クライアントおよびサービス指定のメタデータ。定義された値は次のとおりです：

  • Astra メタデータスキーマに準拠します。作成時に指定しない場合、ラベルのないメタデータオブジェクトが作成されます。更新時に指定されていない場合、メタデータオブジェクトのラベル、creationTimestamp および createdBy は、変更なしで保持されます。

Name を入力します 必須 説明

ラベル

配列["type_astra_label"]

False

作成タイムスタンプ

string

False

modificationTimestamp

string

False

作成者

string

False

modifiedBy

string

False

invalidParams

Name を入力します 必須 説明

名前

string

True

無効なクエリパラメータの名前

理由

string

True

クエリパラメータが無効な理由

invalidFields

Name を入力します 必須 説明

名前

string

True

無効なリクエストボディフィールドの名前

理由

string

True

リクエスト本文フィールドが無効な理由