パブリックエンドポイント、内部エンドポイント、アクセラレーションエンドポイントなど、Object Storage Service (OSS) または特定のリージョンでサポートされているすべてのリージョンのエンドポイントを照会します。
使用上の注意
リージョンのエンドポイントをクエリするには、
oss:DescribeRegions
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。DescribeRegions操作を呼び出すことによって開始されるリクエストには、s oss-cn-hangzhou.aliyuncs.comなどの第2レベルのドメインのみを含めることができます。
リクエスト構文
サポートされているすべてのリージョンのエンドポイントの照会
GET /? リージョンHTTP/1.1 ホスト: oss.example.com 日付: GMT日付 権限付与: SignatureValue
特定のリージョンのエンドポイントの照会
説明OSSリージョンIDを使用してのみ、特定のリージョンのエンドポイントをクエリできます。 詳細については、「パブリッククラウドのリージョンとOSSエンドポイント」をご参照ください。
GET /? リージョン=oss-cn-hangzhou HTTP/1.1 ホスト: oss.example.com 日付: GMT日付 権限付与: SignatureValue
リクエストヘッダー
DescribeRegionsリクエストのすべてのヘッダーは、共通のリクエストヘッダーです。 詳細については、「共通リクエストヘッダー」をご参照ください。
レスポンスヘッダー
DescribeRegions要求に対する応答のすべてのヘッダーは、共通の応答ヘッダーです。 詳細については、「共通レスポンスヘッダー」をご参照ください。
レスポンス要素
要素 | データ型 | 例 | 説明 |
RegionInfoList | Container | N/A | リージョンのリスト。 子ノード: RegionInfo 親ノード: なし |
RegionInfo | Container | N/A | リージョン情報。 子ノード: リージョン、InternetEndpoint、InternalEndpoint、およびAccelerateEndpoint 親ノード: RegionInfoList |
Region | String | oss-cn-hangzhou | OSSリージョンID。 親ノード: RegionInfo |
InternetEndpoint | String | oss-cn-hangzhou.aliyuncs.com | リージョンのパブリックエンドポイント。 親ノード: RegionInfo |
InternalEndpoint | String | oss-cn-hangzhou-internal.aliyuncs.com | リージョンの内部エンドポイント。 親ノード: RegionInfo |
AccelerateEndpoint | String | oss-accelerate.aliyuncs.com | リージョンのアクセラレーションエンドポイント。 値はs oss-accelerate.aliyuncs.com固定されます。 親ノード: RegionInfo |
例
サポートされているすべてのリージョンのエンドポイントの照会
リクエストの例
GET /? リージョンHTTP/1.1 ホスト: oss-cn-hangzhou.aliyuncs.com 日付: 8月20日金曜日2021 06:38:30 GMT 権限付与: SignatureValue
正常に処理された場合のレスポンス例
HTTP/1.1 200 OK x-oss-request-id: 3a8f-2e2d-7965-3ff9-51c875b ***** 日付: 8月20日金曜日2021 06:38:30 GMT Content-Type: application/xml コンテンツ-長さ: 344606 サーバー: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <RegionInfoList> <RegionInfo> <リージョン> oss-cn-hangzhou</リージョン> <InternetEndpoin t>oss-cn-hangzhou.aliyuncs.com</InternetEndpoint> <InternalEndpoin t>oss-cn-hangzhou-internal.aliyuncs.com</InternalEndpoint> <AccelerateEndpoin t>oss-accelerate.aliyuncs.com</AccelerateEndpoint> </RegionInfo> <RegionInfo> <リージョン> oss-cn-shanghai</Region> <InternetEndpoin t>oss-cn-shanghai.aliyuncs.com</InternetEndpoint> <InternalEndpoin t>oss-cn-shanghai-internal.aliyuncs.com</InternalEndpoint> <AccelerateEndpoin t>oss-accelerate.aliyuncs.com</AccelerateEndpoint> </RegionInfo> </RegionInfoList>
特定のリージョンのエンドポイントの照会
リクエストの例
GET /? リージョン=oss-cn-hangzhou HTTP/1.1 ホスト: oss-cn-hangzhou.aliyuncs.com 日付: 8月20日金曜日2021 06:40:30 GMT 権限付与: SignatureValue
正常に処理された場合のレスポンス例
HTTP/1.1 200 OK x-oss-request-id: 3a8f-2e2d-7965-3ff9-51c875b ***** 日付: 8月20日金曜日2021 06:40:30 GMT Content-Type: application/xml コンテンツ-長さ: 3446 サーバー: AliyunOSS <?xml version="1.0" encoding="UTF-8"?> <RegionInfoList> <RegionInfo> <リージョン> oss-cn-hangzhou</リージョン> <InternetEndpoin t>oss-cn-hangzhou.aliyuncs.com</InternetEndpoint> <InternalEndpoin t>oss-cn-hangzhou-internal.aliyuncs.com</InternalEndpoint> <AccelerateEndpoin t>oss-accelerate.aliyuncs.com</AccelerateEndpoint> </RegionInfo> </RegionInfoList>
エラーコード
エラーコード | HTTPステータスコード | 説明 |
AccessDenied | 403 | 考えられる原因:
|
InvalidArgument | 400 | 指定された1つ以上のパラメーターが無効です。 |
NoSuchRegion | 404 | リージョンは存在しません。 |