リクエストされたアーティクルはご利用いただけません。このバージョンの製品で扱われていないか、関連する情報がこのバージョンのドキュメントで別に扱われています。検索 / 参照しなおすか、別のバージョンに戻る場合は、こちらをクリックしてください.

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

バケットを変更する

05/23/2026

PDF

PUT /accounts/{account_id}/topology/v1/buckets/{bucket_id}

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

パラメータ

Name	を入力します	入力	必須	説明
account_id	string	path（パス）	True	包含するアカウントリソースのID 例：{{.Account}}
bucket_id	string	path（パス）	True	リストするバケットコレクションのID

Name

を入力します

入力

必須

説明

account_id

string

path（パス）

True

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

例：{{.Account}}

bucket_id

string

path（パス）

True

リストするバケットコレクションのID

要求の本文

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

Name	を入力します	必須	説明
を入力します	string	True	リソースのメディアタイプ。定義された値は次のとおりです： "application/astra-bucket"
バージョン	string	True	リソースのバージョン。定義された値は次のとおりです： "1.0" "1.1" "1.2"
ID	string	False	リソースのグローバル一意識別子。定義された値は次のとおりです： UUIDv4スキーマに準拠
名前	string	False	バケットにユーザーが割り当てた名前を含むJSON文字列。定義された値は次のとおりです：最小長さ：1 最大長さ：256
credentialID	string	False	バケットへのアクセスに使用される認証情報の識別子を含むJSON文字列。定義された値は次のとおりです： Astra識別子スキーマに準拠
状態	string	False	バケットの動作状態を示す値を含むJSON文字列。定義された値は次のとおりです：「pending」 - バケットは検出予定「available」 - バケットは使用可能です「failed」 - バケットが永続的な失敗状態にあります「removed」 - バケットには現在アクセスできません「不明」 - バケットの状態を判断できません
stateDetails	配列["type_astra_stateDetail"]	False	「state」が「removed」または「failed」に移行した理由に関する詳細情報をリストしたJSONオブジェクトのJSON配列。詳細情報が利用できない場合、この配列は空になります。最小アイテム数：0
プロバイダ	string	False	バケットへのアクセスに使用できるバケットプロトコルを示すJSON文字列。定義された値は次のとおりです： "ontap-s3" "storagegrid-s3" "generic-s3" "gcp" "azure" "aws"
bucketParameters	"bucketParameters"	False	バケットへのアクセスに必要な、バケットプロバイダー固有の情報を提供するJSONオブジェクト。このバケット内の具体的な値は、プロバイダーによって異なります。
メタデータ	"type_astra_metadata_update"	False	リソースに関連付けられた、クライアントおよびサービス指定のメタデータ。定義された値は次のとおりです： Astra メタデータスキーマに準拠します。作成時に指定しない場合、ラベルのないメタデータオブジェクトが作成されます。更新時に指定されていない場合、メタデータオブジェクトのラベル、creationTimestamp および createdBy は、変更なしで保持されます。

Name

を入力します

必須

説明

を入力します

string

True

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

"application/astra-bucket"

バージョン

string

True

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

"1.0"
"1.1"
"1.2"

string

False

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

UUIDv4スキーマに準拠

名前

string

False

バケットにユーザーが割り当てた名前を含むJSON文字列。定義された値は次のとおりです：

最小長さ：1
最大長さ：256

credentialID

string

False

バケットへのアクセスに使用される認証情報の識別子を含むJSON文字列。定義された値は次のとおりです：

Astra識別子スキーマに準拠

状態

string

False

バケットの動作状態を示す値を含むJSON文字列。定義された値は次のとおりです：

「pending」 - バケットは検出予定
「available」 - バケットは使用可能です
「failed」 - バケットが永続的な失敗状態にあります
「removed」 - バケットには現在アクセスできません
「不明」 - バケットの状態を判断できません

stateDetails

配列["type_astra_stateDetail"]

False

「state」が「removed」または「failed」に移行した理由に関する詳細情報をリストしたJSONオブジェクトのJSON配列。詳細情報が利用できない場合、この配列は空になります。

最小アイテム数：0

プロバイダ

string

False

バケットへのアクセスに使用できるバケットプロトコルを示すJSON文字列。定義された値は次のとおりです：

"ontap-s3"
"storagegrid-s3"
"generic-s3"
"gcp"
"azure"
"aws"

bucketParameters

"bucketParameters"

False

バケットへのアクセスに必要な、バケットプロバイダー固有の情報を提供するJSONオブジェクト。このバケット内の具体的な値は、プロバイダーによって異なります。

メタデータ

"type_astra_metadata_update"

False

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

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

リクエスト例

{
  "type": "application/astra-bucket",
  "version": "1.2",
  "name": "New Bucket Name"
}

応答

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

応答

Status: 401, Unauthorized

Name	を入力します	必須
を入力します	string	True
タイトル	string	True
詳細	string	True
ステータス	string	True
correlationID	string	False

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
invalidFields	配列["invalidFields"]	False	無効なリクエストボディフィールドのリスト

Name

を入力します

必須

説明

を入力します

string

True

タイトル

string

True

詳細

string

True

ステータス

string

True

correlationID

string

False

invalidFields

配列["invalidFields"]

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	無効なリクエストボディフィールドのリスト

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

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

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"
}

用語の意味

定義を参照

additionalDetails

type_astra_stateDetail

Name	を入力します	必須
を入力します	string	True
タイトル	string	True
詳細	string	True
additionalDetails	"additionalDetails"	False

Name

を入力します

必須

説明

を入力します

string

True

タイトル

string

True

詳細

string

True

additionalDetails

"additionalDetails"

False

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

Simple Storage Service（S3）プロトコルパラメータを提供するJSONオブジェクト。（すべてのS3タイプのプロバイダーにこのオブジェクトを使用します）。

Name	を入力します	必須	説明
serverURL	string	False	バケットのベースパスへのURLを含むJSON文字列。定義された値は次のとおりです：最小長さ：0 最大長さ：1023
bucketName	string	False	S3バケット名を含むJSON文字列。定義された値は次のとおりです：最小長さ：0 最大長さ：63

Name

を入力します

必須

説明

serverURL

string

False

バケットのベースパスへのURLを含むJSON文字列。定義された値は次のとおりです：

最小長さ：0
最大長さ：1023

bucketName

string

False

S3バケット名を含むJSON文字列。定義された値は次のとおりです：

最小長さ：0
最大長さ：63

gcp

Google Cloudプロトコルパラメータを提供するJSONオブジェクト。

Name	を入力します	必須	説明
bucketName	string	False	バックエンドとなるGoogle Cloudバケット名を含むJSON文字列。定義された値は次のとおりです：最小長さ：0 最大長さ：63

Name

を入力します

必須

説明

bucketName

string

False

バックエンドとなるGoogle Cloudバケット名を含むJSON文字列。定義された値は次のとおりです：

最小長さ：0
最大長さ：63

azure

Azureプロトコルパラメータを提供するJSONオブジェクト。

Name	を入力します	必須	説明
storageAccount	string	False	Azure ストレージアカウント名を含む JSON 文字列。定義された値は次のとおりです：最小長さ：0 最大長さ：63
bucketName	string	False	バックエンドとなるAzureブロブの名前を含むJSON文字列。定義された値は次のとおりです：最小長さ：0 最大長さ：63

Name

を入力します

必須

説明

storageAccount

string

False

Azure ストレージアカウント名を含む JSON 文字列。定義された値は次のとおりです：

最小長さ：0
最大長さ：63

bucketName

string

False

バックエンドとなるAzureブロブの名前を含むJSON文字列。定義された値は次のとおりです：

最小長さ：0
最大長さ：63

bucketParameters

Name	を入力します	必須	説明
s3を使用したチャンクアップロード署名要求がサポートされるようになりました。	"s3を使用したチャンクアップロード署名要求がサポートされるようになりました。"	False	Simple Storage Service（S3）プロトコルパラメータを提供するJSONオブジェクト。（すべてのS3タイプのプロバイダーにこのオブジェクトを使用します）。
gcp	"gcp"	False	Google Cloudプロトコルパラメータを提供するJSONオブジェクト。
azure	"azure"	False	Azureプロトコルパラメータを提供するJSONオブジェクト。

Name

を入力します

必須

説明

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

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

False

Simple Storage Service（S3）プロトコルパラメータを提供するJSONオブジェクト。（すべてのS3タイプのプロバイダーにこのオブジェクトを使用します）。

gcp

"gcp"

False

Google Cloudプロトコルパラメータを提供するJSONオブジェクト。

azure

"azure"

False

Azureプロトコルパラメータを提供するJSONオブジェクト。

type_astra_label

Name	を入力します	必須	説明
名前	string	True
Value	string	True

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

Name

を入力します

必須

説明

ラベル

配列["type_astra_label"]

False

作成タイムスタンプ

string

False

modificationTimestamp

string

False

作成者

string

False

modifiedBy

string

False

invalidParams

Name	を入力します	必須	説明
名前	string	True	無効なクエリパラメータの名前
理由	string	True	クエリパラメータが無効な理由

Name

を入力します

必須

説明

名前

string

True

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

理由

string

True

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

invalidFields

Name	を入力します	必須	説明
名前	string	True	無効なリクエストボディフィールドの名前
理由	string	True	リクエスト本文フィールドが無効な理由

Name

を入力します

必須

説明

名前

string

True

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

理由

string

True

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

バケットを変更する

Creating your file...

パラメータ

要求の本文

応答

応答

応答

応答

応答

エラー

用語の意味