パブリックエンドポイント、内部エンドポイント、アクセラレーションエンドポイントなど、Object Storage Service (OSS) でサポートされているすべてのリージョンまたは特定のリージョンのエンドポイントを照会します。
使用上の注意
- リージョンのエンドポイントをクエリするには、
oss:DescribeRegions
権限が必要です。 詳細については、「RAMユーザーへのカスタムポリシーのアタッチ」をご参照ください。 - DescribeRegions操作を呼び出すことによって開始されるリクエストには、s oss-cn-hangzhou.aliyuncs.comなどの第2レベルのドメインのみを含めることができます。
リクエスト構文
説明 サポートされているリージョンの詳細については、「パブリッククラウドでアクセスするリージョンとOSSエンドポイント」をご参照ください。
- サポートされているすべてのリージョン
のエンドポイントを照会するHTTP/1.1 ホスト: oss.example.com 日付: GMT日付 権限付与: SignatureValue
- 特定のリージョン
のエンドポイントを照会するGET /? リージョン=oss-cn-hangzhou HTTP/1.1 ホスト: oss.example.com 日付: GMT日付 権限付与: SignatureValue
リクエストヘッダー
このリクエストには、共通リクエストヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンスヘッダー
このリクエストには、共通のレスポンスヘッダーのみが含まれます。 詳細については、「共通HTTPヘッダー」をご参照ください。
レスポンス要素
要素 | データ型 | 例 | 説明 |
RegionInfoList | Container | N/A | リージョン情報のリスト。 子ノード: RegionInfo 親ノード: なし |
RegionInfo | Container | N/A | リージョン情報。 子ノード: リージョン、InternetEndpoint、InternalEndpoint、およびAccelerateEndpoint 親ノード: RegionInfoList |
Region | String | oss-cn-hangzhou | リージョンの 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 /? リージョン
- 特定のリージョンのエンドポイントの照会
- サンプルリクエスト
の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 | 指定されたパラメーターが無効な場合に返されるエラーメッセージ。 |
NoSuchRegion | 404 | 指定されたリージョンが存在しない場合に返されるエラーメッセージ。 |