DisassociateResourceShare - - Alibaba Cloud ドキュメントセンター

共有ユニットから共有リソースまたはプリンシパルの関連付けを解除します。

操作説明

リソース所有者はこの操作を呼び出して、共有リソースまたはプリンシパルの関連付けを解除できます。
リソースがリソースディレクトリにないプリンシパルと共有されている場合、プリンシパルはこの操作を呼び出して共有ユニットから退出できます。詳細については、「共有ユニットからの退出」をご参照ください。

このトピックでは、リソースディレクトリの管理アカウントを使用して、中国 (杭州) リージョンの共有ユニット rs-6GRmdD3X**** からプリンシパル 172050525300**** の関連付けを解除し、プリンシパルとのリソース共有を停止する例を示します。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

resourcesharing:DisassociateResourceShare

update

*All Resource

*

resourcesharing:RequestedResourceType
resourcesharing:ResourceArn

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ResourceShareId	string	必須	共有ユニットの ID です。	rs-6GRmdD3X****
Resources	array<object>	任意	リソースのリストです。
	object	任意	リソースのリストです。
ResourceType	string	任意	共有リソースのタイプです。 N は 1 から 5 までの整数です。一度に最大 5 つの共有リソースの関連付けを解除できます。共有可能なリソースタイプの詳細については、「リソース共有と連携するサービス」をご参照ください。説明 Resources.N.ResourceId と Resources.N.ResourceType パラメーターはペアで指定する必要があります。	VSwitch
ResourceId	string	任意	共有リソースの ID です。 N は 1 から 5 までの整数です。一度に最大 5 つの共有リソースの関連付けを解除できます。説明 Resources.N.ResourceId と Resources.N.ResourceType パラメーターはペアで指定する必要があります。	vsw-bp183p93qs667muql****
Targets	array	任意	プリンシパルです。	172050525300****
	string	任意	プリンシパルです。 N は 1 から 5 までの整数です。一度に最大 5 つのプリンシパルの関連付けを解除できます。	172050525300****
ResourceArns	array	任意	共有リソースの Alibaba Cloud リソースネーム (ARN) のリストです。 N は 1 から 5 までの整数です。一度に最大 5 つの共有リソースの関連付けを解除できます。
	string	任意	共有リソースの ARN です。説明 ARN のフォーマットの詳細については、「リソース共有と連携するサービス」をご参照ください。	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
ResourceOwner	string	任意	共有ユニットのオーナーです。有効な値： Self (デフォルト)：共有ユニットは現在のアカウントに属します。これは、リソース所有者がリソースディレクトリ内の共有ユニットから共有リソースまたはプリンシパルの関連付けを解除する場合に適用されます。 OtherAccounts：共有ユニットは別のアカウントに属します。これは、プリンシパルがリソースディレクトリ外の共有ユニットから自発的に退出する場合に適用されます。	Self

レスポンスフィールド

フィールド	型	説明	例
	object	レスポンスパラメーターです。
RequestId	string	リクエスト ID です。	95230BC9-A8E8-4493-96BD-4F0C758E37F8
ResourceShareAssociations	array<object>	関連付けに関する情報です。
	object	関連付けに関する情報です。
UpdateTime	string	関連付けが最後に更新された時刻です。この時刻は、AssociationType の値によって異なります： `AssociationType` が `Resource` の場合、このパラメーターはリソースの関連付け解除が更新された時刻を示します。 `AssociationType` が `Target` の場合、このパラメーターはプリンシパルの関連付け解除が更新された時刻を示します。	2020-12-04T09:40:45.556Z
ResourceArn	string	関連付けられたリソースの ARN です。説明このパラメーターは、`AssociationType` が `Target` の場合は返されません。	acs:vpc:cn-shanghai:103755469187**:vswitch/vsw-uf62b11ue4m8oz2di**
ResourceShareName	string	共有ユニットの名前です。	test
CreateTime	string	関連付け解除が作成された時刻です。この時刻は、AssociationType の値によって異なります： `AssociationType` が `Resource` の場合、このパラメーターは共有リソースの関連付けが解除された時刻を示します。 `AssociationType` が `Target` の場合、このパラメーターはプリンシパルの関連付けが解除された時刻を示します。	2020-12-04T09:40:41.250Z
EntityType	string	関連付けられたエンティティのタイプです。有効な値：エンティティがリソースの場合、このパラメーターの値はリソースタイプです。詳細については、「リソース共有と連携するサービス」をご参照ください。エンティティがプリンシパルの場合、このパラメーターの値は Account です。	Account
ResourceShareId	string	共有ユニットの ID です。	rs-6GRmdD3X****
AssociationStatusMessage	string	関連付け解除が失敗した理由です。	The Resources is invalid.
AssociationType	string	関連付けのタイプです。有効な値： Resource：リソース。 Target：プリンシパル。	Target
AssociationStatus	string	関連付けのステータスです。有効な値： Associating：エンティティは関連付け中です。 Associated：エンティティは関連付け済みです。 Failed：関連付けに失敗しました。 Disassociating：エンティティは関連付け解除中です。 Disassociated：エンティティは関連付け解除済みです。説明システムは、`Failed` または `Disassociated` 状態のレコードを 48〜96 時間以内に自動的に削除します。	Disassociating
TargetProperty	string	リソース共有の期間など、プリンシパルのプロパティです。説明このパラメーターは、プリンシパルが Alibaba Cloud サービスの場合にのみ返されます。	{ "timeRange":{ "timeRangeType":"timeRange", "beginAtTime":"00:00", "timezone":"UTC+8", "endAtTime":"19:59" } }
EntityId	string	関連付けられたエンティティの ID です。有効な値： `AssociationType` が `Resource` の場合、このパラメーターの値はリソースの ID です。 `AssociationType` が `Target` の場合、このパラメーターの値はリソースディレクトリ、フォルダ、またはメンバーの ID です。	172050525300****
ResourceProperty	string		{"sharePrincipals":true,"shareTagOptions":false}

例

成功レスポンス

JSONJSON

{
  "RequestId": "95230BC9-A8E8-4493-96BD-4F0C758E37F8",
  "ResourceShareAssociations": [
    {
      "UpdateTime": "2020-12-04T09:40:45.556Z",
      "ResourceArn": "acs:vpc:cn-shanghai:103755469187****:vswitch/vsw-uf62b11ue4m8oz2di****",
      "ResourceShareName": "test",
      "CreateTime": "2020-12-04T09:40:41.250Z",
      "EntityType": "Account",
      "ResourceShareId": "rs-6GRmdD3X****",
      "AssociationStatusMessage": "The Resources is invalid.",
      "AssociationType": "Target",
      "AssociationStatus": "Disassociating",
      "TargetProperty": "{\n    \"timeRange\":{\n        \"timeRangeType\":\"timeRange\",\n        \"beginAtTime\":\"00:00\",\n        \"timezone\":\"UTC+8\",\n        \"endAtTime\":\"19:59\"\n    }\n}",
      "EntityId": "172050525300****",
      "ResourceProperty": "{\"sharePrincipals\":true,\"shareTagOptions\":false}"
    }
  ]
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	MissingParameter.ResourceShareId	You must specify ResourceShareId.	You must specify ResourceShareId.
400	InvalidParameter.ResourceShareId	The ResourceShareId is invalid.	The ResourceShareId is invalid.
400	InvalidParameter.Resources	The Resources is invalid.	The Resources is invalid.
400	InvalidParameter.Resources.Duplicate	The Resources contains duplicate values.	The Resources contains duplicate values.
400	InvalidParameter.Resources.Length	The maximum number of Resources exceeds 5.	The maximum number of Resources exceeds 5.
400	InvalidParameter.Targets	The Targets is invalid.	The Targets is invalid.
400	InvalidParameter.Targets.Duplicate	The Targets contains duplicate values.	The Targets contains duplicate values.
400	InvalidParameter.Targets.Length	The maximum number of Targets exceeds 5.	The maximum number of Targets exceeds 5.
400	ResourceAndTargetBothEmpty	Either a resource or a shared target must be specified.	Either a resource or a target must be specified.
400	DisassociateInvalid	You can not disassociate unassociated resource or target.	You cannot disassociate unassociated resource or target.
400	InvalidParameter	The specified parameter is invalid.	The specified parameter is invalid.
400	InvalidParameter.ResourceType	The ResourceType is invalid.	The ResourceType is invalid.
400	InvalidParameter.ResourceArns	The ResourceArns is invalid.
400	InvalidParameter.ResourceArns.Duplicate	The ResourceArns contains duplicate values.
400	InvalidParameter.ResourceArns.Length	The ResourceArns beyond the length limit.
400	InvalidParameter.ResourceConflict	Both Resources and ResourceArns cannot be specified simultaneously. Please provide only one of these parameters.
400	NotSupport.ResourceType.ResourcesParameter	The Resources parameter does not support this resource type. Please use ResourceArns instead.
404	EntityNotExists.ResourceShare	The resource share does not exist in the current account.	The resource share does not exist in the current account.
409	AccountNotInResourceDirectory	The account is not a master or a member of a resource directory.	The account is not a master or a member of a resource directory.
409	ResourceShareStatusMismatchAction	The status of the resource share does not allow the specified operation.	The status of the resource share does not allow the specified operation.
409	DisassociateConflict	You cannot perform the operation while association is already in progress.	You cannot perform the operation while association is already in progress.
409	LeavingFailed.Account	The account was added to the resource share automatically by resoucre directory.
409	LeavingFailed.ResourceType	The resource share contains resources of the resource types that dont support this action.
409	ExternalTargetWithdrawConflict	Existing internal association task in resource directory when disassociating with resource share.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。