共通パラメーターを使用して、Alibaba Cloud のリージョン、ゾーン、およびクラウドプロダクトに関する情報を取得します。 - CloudOps Orchestration Service

CloudOps Orchestration Service (OOS) の共通パラメーターは、Alibaba Cloud によって管理および保守されています。共通パラメーターを使用して、Alibaba Cloud のリージョン、ゾーン、クラウドサービス、およびエンドポイントに関する情報を取得できます。

前提条件

Alibaba Cloud CLI がインストールおよび構成されていること。Alibaba Cloud CLI がインストールまたは構成されていない場合は、以下を参照してください。

説明

一時的なデバッグ操作のみを実行する必要がある場合は、Alibaba Cloud CLI をインストールする必要はありません。Alibaba Cloud が提供する [Cloud Shell] を使用して、クラウドサービスホストに関する情報を取得できます。

Alibaba Cloud CLI をインストールします。
Alibaba Cloud CLI を構成します。
Alibaba Cloud リソースを使用するために必要な資格情報やリージョンなどのパラメーターを構成します。情報の構成方法の詳細については、「ID 資格情報の種類」をご参照ください。

手順

Alibaba Cloud リージョンに関する情報を取得する

すべてのリージョン

リクエストコマンド
Alibaba Cloud CLI で次のコマンドを実行して GetParametersByPath 操作を呼び出し、共通パラメーターパスを使用してすべての Alibaba Cloud リージョンをすばやくクエリできます。
```
aliyun oos GetParametersByPath --Path aliyun/services/global-infrastructure/regions
```
Path は、取得するパラメーターのパスを指定します。このシナリオでは、パスは aliyun/services/global-infrastructure/regions に設定されており、リクエストがすべてのリージョンに関する情報を取得することを示しています。

成功応答の例

応答例には、リージョン ID と名前、作成時刻、更新時刻、その他の情報が含まれています。cn-hangzhou や cn-shanghai など、一部のリージョンのみが表示されます。

例: cn-hangzhou と cn-shanghai リージョン情報

{
 "MaxResults": 10,
 "Parameters": [
 {
 "Id": "p-xxxxxx",
 "Name": "aliyun/services/global-infrastructure/regions/cn-hangzhou",
 "CreatedDate": "2023-05-17T06:21:15Z",
 "UpdatedDate": "2023-05-17T06:21:15Z",
 "Value": "cn-hangzhou" //杭州
 },
 {
 "Id": "p-xxxxxx",
 "Name": "aliyun/services/global-infrastructure/regions/cn-shanghai",
 "CreatedDate": "2023-05-17T06:21:15Z",
 "UpdatedDate": "2023-05-17T06:21:15Z",
 "Value": "cn-shanghai" //上海
 }
 ],
 "RequestId": "xxxxxxxxxxxxxx"
}

サービスでサポートされているリージョン

リクエストコマンド
Alibaba Cloud CLI で次のコマンドを実行して GetParametersByPath 操作を呼び出し、共通パラメーターパスを使用して Alibaba Cloud サービスでサポートされているリージョンをすばやくクエリできます。
```
aliyun oos GetParametersByPath --Path aliyun/services/global-infrastructure/products/oos/regions
```
Path は、取得するパラメーターのパスを指定します。このシナリオでは、パスは aliyun/services/global-infrastructure/products/{product_code}/regions に設定されています。{product_code} を oos などの特定のサービスのコードに設定します。

成功応答の例

応答例には、リージョン ID と名前、作成時刻、更新時刻、その他の情報が含まれています。一部のリージョンのみが表示されます。たとえば、OOS は cn-hangzhou と cn-shanghai でサポートされています。

例：OOS でサポートされているリージョン

{
 "MaxResults": 10,
 "Parameters": [
 {
 "Id": "p-xxxxxx",
 "Name": "aliyun/services/global-infrastructure/products/oos/regions/cn-hangzhou",
 "CreatedDate": "2023-05-17T06:21:15Z",
 "UpdatedDate": "2023-05-17T06:21:15Z",
 "Value": "cn-hangzhou" //杭州
 },
 {
 "Id": "p-xxxxxx",
 "Name": "aliyun/services/global-infrastructure/products/oos/regions/cn-shanghai",
 "CreatedDate": "2023-05-17T06:21:15Z",
 "UpdatedDate": "2023-05-17T06:21:15Z",
 "Value": "cn-shanghai" //上海
 }
 ],
 "RequestId": "xxxxxxxxxxxxxx"
}

すべての Alibaba Cloud ゾーンをクエリする

リクエストコマンド
Alibaba Cloud CLI で次のコマンドを実行して GetParametersByPath 操作を呼び出し、共通パラメーターパスを使用してすべての Alibaba Cloud ゾーンをクエリできます。
```
aliyun oos GetParametersByPath --Path aliyun/services/global-infrastructure/availability-zones
```
Path を取得するパラメーターパスに設定します。このシナリオでは、パスは aliyun/services/global-infrastructure/availability-zones に設定されており、リクエストがすべてのゾーンをクエリすることを示しています。

成功応答の例

応答例には、ゾーン ID と名前、作成時刻、更新時刻、その他の情報が含まれています。cn-shanghai-g-alipay や cn-shanghai-x6 など、一部のゾーンのみが表示されます。

例: cn-shanghai-g-alipay と cn-shanghai-x6 ゾーン情報

{
 "MaxResults": 10,
 "Parameters": [
 {
 "Id": "p-xxxxxx",
 "Name": "aliyun/services/global-infrastructure/availability-zones/cn-shanghai-g-alipay",
 "CreatedDate": "2023-05-17T06:21:15Z",
 "UpdatedDate": "2023-05-17T06:21:15Z",
 "Value": "cn-shanghai-g-alipay"
 },
 {
 "Id": "p-xxxxxx",
 "Name": "aliyun/services/global-infrastructure/availability-zones/cn-shanghai-x6",
 "CreatedDate": "2023-05-17T06:21:15Z",
 "UpdatedDate": "2023-05-17T06:21:15Z",
 "Value": "cn-shanghai-x6"
 }
 ],
 "RequestId": "xxxxxxxxxxxxxx"
}

Alibaba Cloud サービスをクエリする

リクエストコマンド
Alibaba Cloud CLI で次のコマンドを実行して GetParametersByPath 操作を呼び出し、共通パラメーターパスを使用して Alibaba Cloud サービスをクエリできます。
```
aliyun oos GetParametersByPath --Path aliyun/services/global-infrastructure/products
```
Path を取得するパラメーターパスに設定します。このシナリオでは、パスは aliyun/services/global-infrastructure/products に設定されており、リクエストがすべてのゾーンをクエリすることを示しています。

成功応答の例

応答例には、サービス ID と名前、作成時刻、更新時刻、その他の情報が含まれています。OOS や ECS など、一部のクラウドプロダクトのみが表示されます。

例: OOSとECS情報

{
 "MaxResults": 10,
 "Parameters": [
 {
 "Id": "p-xxxxxx",
 "Name": "aliyun/services/global-infrastructure/products/oos",
 "CreatedDate": "2023-05-17T06:21:15Z",
 "UpdatedDate": "2023-05-17T06:21:15Z",
 "Value": "oos" // 運用オーケストレーションサービス
 },
 {
 "Id": "p-xxxxxx",
 "Name": "aliyun/services/global-infrastructure/products/ecs",
 "CreatedDate": "2023-05-17T06:21:15Z",
 "UpdatedDate": "2023-05-17T06:21:15Z",
 "Value": "ecs" // 弾性計算サービス
 }
 ],
 "RequestId": "xxxxxxxxxxxxxx"
}

サービスのエンドポイントをクエリする

リクエストコマンド
Alibaba Cloud CLI で次のコマンドを実行して GetParametersByPath 操作を呼び出し、共通パラメーターパスを使用して Alibaba Cloud サービスのエンドポイントをクエリできます。
```
aliyun oos GetParametersByPath --Path aliyun/services/global-infrastructure/products/oos/endpoints
```
Path を取得するパラメーターパスに設定します。このシナリオでは、パスは aliyun/services/global-infrastructure/products/{product_code}/endpoints に設定されています。ここで、{product_code} は oos などの特定のサービスのコードです。

成功応答の例

応答例には、エンドポイント ID と名前、作成時刻、更新時刻、その他の情報が含まれています。一部のリージョンにおける OOS のエンドポイントのみが表示されます。たとえば、cn-hangzhou と cn-shanghai における OOS のエンドポイントを取得できます。

例：一部のリージョンにおける OOS エンドポイント

{
 "MaxResults": 10,
 "Parameters": [
 {
 "Id": "p-xxxxxx",
 "Name": "aliyun/services/global-infrastructure/products/oos/endpoints/endpoint-cn-hangzhou",
 "CreatedDate": "2023-05-17T06:21:15Z",
 "UpdatedDate": "2023-05-17T06:21:15Z",
 "Value": "oos.cn-hangzhou.aliyuncs.com"
 },
 {
 "Id": "p-xxxxxx",
 "Name": "aliyun/services/global-infrastructure/products/oos/endpoints/endpoint-cn-shanghai",
 "CreatedDate": "2023-05-17T06:21:15Z",
 "UpdatedDate": "2023-05-17T06:21:15Z",
 "Value": "oos.cn-shanghai.aliyuncs.com"
 }
 ],
 "RequestId": "xxxxxxxxxxxxxx"
}