AddIpamMembers - Virtual Private Cloud - Alibaba Cloud ドキュメントセンター

操作説明

リソースディレクトリ内の IPAM インスタンスの委任された管理者のみが、マルチアカウント管理を実行できます。
IPAM の委任された管理者は、1 つのリージョンでのみ IPAM インスタンスを使用してマルチアカウント管理を行うことができます。最大 1,000 のメンバーアカウントを追加できます。
重要フォルダをメンバーとして追加すると、そのフォルダ内にあるリソースディレクトリのすべてのメンバーアカウントがカウントされます。
メンバーのタイプは、フォルダまたはアカウントです。
- フォルダ：IPAM の委任された管理者は、フォルダ内にあるリソースディレクトリのすべてのメンバーアカウントの IP アドレス使用状況を表示できます。使用状況は、IPAM インスタンスがデプロイされているリージョンで表示されます。
- アカウント：IPAM の委任された管理者は、リソースディレクトリの特定のメンバーアカウントの IP アドレス使用状況を表示できます。使用状況は、IPAM インスタンスがデプロイされているリージョンで表示されます。
管理対象メンバーは、そのリソース検出を IPAM の委任された管理者と共有できません。メンバーがすでにリソース検出を共有している場合、IPAM の委任された管理者はそのメンバーを追加できません。
最初のメンバーを追加すると、リソースディレクトリの IPAM 信頼できるサービスが有効になります。

今すぐお試しください

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

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST  HTTP/1.1

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	IPAM が管理するリージョンの ID。 DescribeRegions 操作を呼び出して、リージョン ID を取得できます。	cn-hangzhou
DryRun	boolean	任意	ドライランを実行するかどうかを指定します。有効な値： true：ドライランを実行します。リクエストは、必須パラメーター、リクエスト形式、およびサービス制限についてチェックされます。メンバーは IPAM の信頼できるサービスに追加されません。チェックに合格すると、DryRunOperation エラーコードが返されます。チェックに失敗すると、エラーが返されます。 false (デフォルト)：通常のリクエストを送信します。リクエストがチェックに合格すると、メンバーは IPAM の信頼できるサービスに追加され、HTTP 2xx ステータスコードが返されます。	false
ClientToken	string	任意	リクエストのべき等性を保証するためのクライアントトークン。リクエストごとにクライアントから一意の値を生成します。ClientToken パラメーターは ASCII 文字のみをサポートします。説明このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として使用します。RequestId は API リクエストごとに異なる場合があります。	123e4567-e89b-12d3-a456-426655440000
Members	array<object>	必須	IPAM の信頼できるサービスによって管理されるメンバー。
	object	任意
MemberId	string	任意	メンバー ID。フォルダ ID：フォルダの ID。アカウント UID：リソースディレクトリ内のメンバーアカウントの UID。	fd-ccccncASqa
MemberType	string	任意	メンバーのタイプ。有効な値： Folder：フォルダ。 Account：リソースディレクトリ内のメンバーアカウント。列挙値: Account : リソースディレクトリ内のメンバーアカウント Folder : リソースディレクトリ内のフォルダ	Folder

レスポンスフィールド

フィールド	型	説明	例
	object	BaseResult
RequestId	string	リクエスト ID。	BB2C39DE-CEB8-595A-981A-F2EFCBE7324E

例

成功レスポンス

JSONJSON

{
  "RequestId": "BB2C39DE-CEB8-595A-981A-F2EFCBE7324E"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	OperationDenied.MemberIdNotMatchMemberType	The operation is not allowed because the Member ID and Member Type of members [%s] in the input parameters do not match.
400	OperationDenied.MemberExistInIpamRDService	The operation is not allowed because %s is under the management of the IPAM.
400	QuotaExceeded.MemberAccount	The operation is not allowed because the number of % managed by IPAM has exceeded the limit, %s/%s.
400	OperationDenied.IpamResourceDiscoveryAlreadySharedWithAdmin	The operation is not allowed because the resource discovery has been shared with the IPAM delegated administrator by %s.
400	OperationDenied.IpamRDServiceAlreadyEnabledInOtherRegion	The operation is not allowed because the IPAM Resource Directory service is already enabled in another region.
400	OperationDenied.AccountNotRDEntity	The operation is not allowed because the caller does not belong to the resource directory.
400	OperationDenied.NotDelegatedAdminAccount	The operation is not allowed because the caller is not the delegated IPAM admin for the resource directory.
400	OperationDenied.IpamNotExist	The operation is not allowed because the IPAM does not exist.
400	OperationDenied.DelegateAdminAsMember	The operation is not allowed because the IPAM delegate administrator cannot be a member.
400	OperationDenied.NoServicePrincipalAdminPrivileges	The operation is not allowed because the caller is not the delegated IPAM admin for the resource directory.

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

変更履歴

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