调用 Amazon Web Services、区域、端点、可用区、Local Zone 和 Wavelength Zone 的公有参数 - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

调用 Amazon Web Services、区域、端点、可用区、Local Zone 和 Wavelength Zone 的公有参数

您可以使用以下路径调用 Amazon Web Services 区域、服务、端点、可用区和 Wavelength 区域的公有参数。

/aws/service/global-infrastructure

查看处于活动状态的 Amazon Web Services 区域

您可以在 Amazon Command Line Interface (Amazon CLI) 中使用以下命令查看所有活动 Amazon Web Services 区域的列表。

Linux & macOS
aws ssm get-parameters-by-path \ --path /aws/service/global-infrastructure/regions \ --query 'Parameters[].Name'
Windows
aws ssm get-parameters-by-path ^ --path /aws/service/global-infrastructure/regions ^ --query Parameters[].Name

此命令会返回如下信息。

[
    "/aws/service/global-infrastructure/regions/af-south-1",
    "/aws/service/global-infrastructure/regions/ap-east-1",
    "/aws/service/global-infrastructure/regions/ap-northeast-3",
    "/aws/service/global-infrastructure/regions/ap-southeast-1",
    "/aws/service/global-infrastructure/regions/ca-central-1",
    "/aws/service/global-infrastructure/regions/cn-north-1",
    "/aws/service/global-infrastructure/regions/eu-west-2",
    "/aws/service/global-infrastructure/regions/eu-west-3",
    "/aws/service/global-infrastructure/regions/us-east-1",
    "/aws/service/global-infrastructure/regions/us-gov-west-1",
    "/aws/service/global-infrastructure/regions/ap-northeast-2",
    "/aws/service/global-infrastructure/regions/ap-south-1",
    "/aws/service/global-infrastructure/regions/ap-southeast-2",
    "/aws/service/global-infrastructure/regions/cn-northwest-1",
    "/aws/service/global-infrastructure/regions/eu-south-1",
    "/aws/service/global-infrastructure/regions/me-south-1",
    "/aws/service/global-infrastructure/regions/sa-east-1",
    "/aws/service/global-infrastructure/regions/us-east-2",
    "/aws/service/global-infrastructure/regions/us-gov-east-1",
    "/aws/service/global-infrastructure/regions/us-west-1",
    "/aws/service/global-infrastructure/regions/ap-northeast-1",
    "/aws/service/global-infrastructure/regions/eu-central-1",
    "/aws/service/global-infrastructure/regions/eu-north-1",
    "/aws/service/global-infrastructure/regions/eu-west-1",
    "/aws/service/global-infrastructure/regions/us-west-2"
]
查看可用的 Amazon Web Services

您可以使用以下命令查看所有可用 Amazon Web Services的完整列表,并将其按字母顺序排序。此示例输出已由于空间问题截断。

Linux & macOS
aws ssm get-parameters-by-path \ --path /aws/service/global-infrastructure/services \ --query 'Parameters[].Name | sort(@)'
Windows
aws ssm get-parameters-by-path ^ --path /aws/service/global-infrastructure/services ^ --query "Parameters[].Name | sort(@)"

此命令会返回如下信息。

[
    "/aws/service/global-infrastructure/services/accessanalyzer",
    "/aws/service/global-infrastructure/services/account",
    "/aws/service/global-infrastructure/services/acm",
    "/aws/service/global-infrastructure/services/acm-pca",
    "/aws/service/global-infrastructure/services/ahl",
    "/aws/service/global-infrastructure/services/aiq",
    "/aws/service/global-infrastructure/services/alexaforbusiness",
    "/aws/service/global-infrastructure/services/amazonlocationservice",
    "/aws/service/global-infrastructure/services/amp",
    "/aws/service/global-infrastructure/services/amplify",
    "/aws/service/global-infrastructure/services/amplifybackend",
    "/aws/service/global-infrastructure/services/apigateway",
    "/aws/service/global-infrastructure/services/apigatewaymanagementapi",
    "/aws/service/global-infrastructure/services/apigatewayv2",
    "/aws/service/global-infrastructure/services/appconfig",
    "/aws/service/global-infrastructure/services/appconfigdata",
    "/aws/service/global-infrastructure/services/appflow",
    "/aws/service/global-infrastructure/services/appintegrations",
    "/aws/service/global-infrastructure/services/application-autoscaling",
    "/aws/service/global-infrastructure/services/application-insights",
    "/aws/service/global-infrastructure/services/applicationcostprofiler",
    "/aws/service/global-infrastructure/services/appmesh",
    "/aws/service/global-infrastructure/services/apprunner",
查看支持某个 Amazon Web Service的区域

您可以查看提供服务的 Amazon Web Services 区域列表。此示例使用 Amazon Systems Manager (ssm)。

Linux & macOS
aws ssm get-parameters-by-path \ --path /aws/service/global-infrastructure/services/ssm/regions \ --query 'Parameters[].Value'
Windows
aws ssm get-parameters-by-path ^ --path /aws/service/global-infrastructure/services/ssm/regions ^ --query Parameters[].Value

此命令会返回如下信息。

[
    "ap-northeast-3",
    "ap-south-1",
    "cn-north-1",
    "eu-central-1",
    "eu-west-1",
    "eu-west-2",
    "eu-west-3",
    "me-south-1",
    "us-east-2",
    "us-gov-west-1",
    "af-south-1",
    "ap-east-1",
    "ap-northeast-1",
    "ap-southeast-1",
    "ap-southeast-3",
    "ca-central-1",
    "eu-north-1",
    "eu-south-1",
    "us-gov-east-1",
    "us-west-1",
    "ap-northeast-2",
    "ap-southeast-2",
    "cn-northwest-1",
    "sa-east-1",
    "us-east-1",
    "us-west-2"
]
查看服务的区域端点

您可以使用以下命令查看服务的区域端点。

Linux & macOS
aws ssm get-parameter \ --name /aws/service/global-infrastructure/regions/us-east-2/services/ssm/endpoint \ --query 'Parameter.Value'
Windows
aws ssm get-parameter ^ --name /aws/service/global-infrastructure/regions/us-east-2/services/ssm/endpoint ^ --query Parameter.Value

此命令会返回如下信息。

"ssm.us-east-2.amazonaws.com"
查看完整的可用区详细信息

您可以使用以下命令查看可用区。

Linux & macOS
aws ssm get-parameters-by-path \ --path /aws/service/global-infrastructure/availability-zones/
Windows
aws ssm get-parameters-by-path ^ --path /aws/service/global-infrastructure/availability-zones/

此命令会返回如下信息。此示例输出已由于空间问题截断。

{
    "Parameters": [
        {
            "Name": "/aws/service/global-infrastructure/availability-zones/afs1-az3",
            "Type": "String",
            "Value": "afs1-az3",
            "Version": 1,
            "LastModifiedDate": "2020-04-21T09:05:35.375000-07:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/availability-zones/afs1-az3",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/availability-zones/apne2-az3",
            "Type": "String",
            "Value": "apne2-az3",
            "Version": 1,
            "LastModifiedDate": "2020-04-03T13:19:44.642000-07:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/availability-zones/apne2-az3",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/availability-zones/aps1-az2",
            "Type": "String",
            "Value": "aps1-az2",
            "Version": 1,
            "LastModifiedDate": "2020-04-03T13:13:57.351000-07:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/availability-zones/aps1-az2",
            "DataType": "text"
        }
    ]
}
仅查看可用区名称

您可以使用以下命令仅查看可用区的名称。

Linux & macOS
aws ssm get-parameters-by-path \ --path /aws/service/global-infrastructure/availability-zones \ --query 'Parameters[].Name | sort(@)'
Windows
aws ssm get-parameters-by-path ^ --path /aws/service/global-infrastructure/availability-zones ^ --query "Parameters[].Name | sort(@)"

此命令会返回如下信息。此示例输出已由于空间问题截断。

[
    "/aws/service/global-infrastructure/availability-zones/afs1-az1",
    "/aws/service/global-infrastructure/availability-zones/afs1-az2",
    "/aws/service/global-infrastructure/availability-zones/afs1-az3",
    "/aws/service/global-infrastructure/availability-zones/ape1-az1",
    "/aws/service/global-infrastructure/availability-zones/ape1-az2",
    "/aws/service/global-infrastructure/availability-zones/ape1-az3",
    "/aws/service/global-infrastructure/availability-zones/apne1-az1",
    "/aws/service/global-infrastructure/availability-zones/apne1-az2",
    "/aws/service/global-infrastructure/availability-zones/apne1-az3",
    "/aws/service/global-infrastructure/availability-zones/apne1-az4",
查看单个区域中的可用区的名称

您可以使用以下命令查看一个区域(在此示例中为 us-east-2)中的可用区的名称。

Linux & macOS
aws ssm get-parameters-by-path \ --path /aws/service/global-infrastructure/regions/us-east-1/availability-zones \ --query 'Parameters[].Name | sort(@)'
Windows
aws ssm get-parameters-by-path ^ --path /aws/service/global-infrastructure/regions/us-east-1/availability-zones ^ --query "Parameters[].Name | sort(@)"

此命令会返回如下信息。此示例输出已由于空间问题截断。

[
    "/aws/service/global-infrastructure/regions/us-east-1/availability-zones/use1-az1",
    "/aws/service/global-infrastructure/regions/us-east-1/availability-zones/use1-az2",
    "/aws/service/global-infrastructure/regions/us-east-1/availability-zones/use1-az3",
    "/aws/service/global-infrastructure/regions/us-east-1/availability-zones/use1-az4",
    "/aws/service/global-infrastructure/regions/us-east-1/availability-zones/use1-az5",
    "/aws/service/global-infrastructure/regions/us-east-1/availability-zones/use1-az6"
仅查看可用区 ARN

您可以使用以下命令仅查看可用区的 Amazon Resource Name (ARN)。

Linux & macOS
aws ssm get-parameters-by-path \ --path /aws/service/global-infrastructure/availability-zones \ --query 'Parameters[].ARN | sort(@)'
Windows
aws ssm get-parameters-by-path ^ --path /aws/service/global-infrastructure/availability-zones ^ --query "Parameters[].ARN | sort(@)"

此命令会返回如下信息。此示例输出已由于空间问题截断。

[
    "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/availability-zones/afs1-az1",
    "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/availability-zones/afs1-az2",
    "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/availability-zones/afs1-az3",
    "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/availability-zones/ape1-az1",
    "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/availability-zones/ape1-az2",
    "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/availability-zones/ape1-az3",
    "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/availability-zones/apne1-az1",
查看本地区域详细信息

您可以使用以下命令查看本地区域。

Linux & macOS
aws ssm get-parameters-by-path \ --path /aws/service/global-infrastructure/local-zones
Windows
aws ssm get-parameters-by-path ^ --path /aws/service/global-infrastructure/local-zones

此命令会返回如下信息。此示例输出已由于空间问题截断。

{
    "Parameters": [
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-bos1-az1",
            "Type": "String",
            "Value": "use1-bos1-az1",
            "Version": 3,
            "LastModifiedDate": "2020-12-15T14:16:17.502000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-bos1-az1",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-chi1-az1",
            "Type": "String",
            "Value": "use1-chi1-az1",
            "Version": 1,
            "LastModifiedDate": "2021-09-08T10:05:38.634000-07:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-chi1-az1",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-dfw1-az1",
            "Type": "String",
            "Value": "use1-dfw1-az1",
            "Version": 1,
            "LastModifiedDate": "2021-07-07T05:28:16.412000-07:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-dfw1-az1",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-mci1-az1",
            "Type": "String",
            "Value": "use1-mci1-az1",
            "Version": 1,
            "LastModifiedDate": "2021-09-08T10:05:37.571000-07:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-mci1-az1",
            "DataType": "text"
        }
    ]
}
查看 Wavelength 区域详细信息

您可以使用以下命令查看 Wavelength 区域。

Linux & macOS
aws ssm get-parameters-by-path \ --path /aws/service/global-infrastructure/wavelength-zones
Windows
aws ssm get-parameters-by-path ^ --path /aws/service/global-infrastructure/wavelength-zones

此命令会返回如下信息。此示例输出已由于空间问题截断。

{
    "Parameters": [
        {
            "Name": "/aws/service/global-infrastructure/wavelength-zones/apne1-wl1-nrt-wlz1",
            "Type": "String",
            "Value": "apne1-wl1-nrt-wlz1",
            "Version": 3,
            "LastModifiedDate": "2020-12-15T14:16:04.715000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/wavelength-zones/apne1-wl1-nrt-wlz1",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/wavelength-zones/use1-wl1-atl-wlz1",
            "Type": "String",
            "Value": "use1-wl1-atl-wlz1",
            "Version": 3,
            "LastModifiedDate": "2020-09-22T13:10:11.783000-07:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/wavelength-zones/use1-wl1-atl-wlz1",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/wavelength-zones/use1-wl1-bos-wlz1",
            "Type": "String",
            "Value": "use1-wl1-bos-wlz1",
            "Version": 3,
            "LastModifiedDate": "2020-08-06T07:11:23.225000-07:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/wavelength-zones/use1-wl1-bos-wlz1",
            "DataType": "text"
        }
    ]
}
查看本地区域下的所有参数和值

您可以使用以下命令查看本地区域的所有参数数据。

Linux & macOS
aws ssm get-parameters-by-path \ --path "/aws/service/global-infrastructure/local-zones/usw2-lax1-az1/"
Windows
aws ssm get-parameters-by-path ^ --path "/aws/service/global-infrastructure/local-zones/use1-bos1-az1"

此命令会返回如下信息。

{
    "Parameters": [
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/geolocationCountry",
            "Type": "String",
            "Value": "US",
            "Version": 3,
            "LastModifiedDate": "2020-12-15T14:16:17.641000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-bos1-az1/geolocationCountry",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/geolocationRegion",
            "Type": "String",
            "Value": "US-MA",
            "Version": 3,
            "LastModifiedDate": "2020-12-15T14:16:17.794000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-bos1-az1/geolocationRegion",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/location",
            "Type": "String",
            "Value": "US East (Boston)",
            "Version": 1,
            "LastModifiedDate": "2021-01-11T10:53:24.634000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-bos1-az1/location",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/network-border-group",
            "Type": "String",
            "Value": "us-east-1-bos-1",
            "Version": 3,
            "LastModifiedDate": "2020-12-15T14:16:20.641000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-bos1-az1/network-border-group",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/parent-availability-zone",
            "Type": "String",
            "Value": "use1-az4",
            "Version": 3,
            "LastModifiedDate": "2020-12-15T14:16:20.834000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-bos1-az1/parent-availability-zone",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/parent-region",
            "Type": "String",
            "Value": "us-east-1",
            "Version": 3,
            "LastModifiedDate": "2020-12-15T14:16:20.721000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-bos1-az1/parent-region",
            "DataType": "text"
        },
        {
            "Name": "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/zone-group",
            "Type": "String",
            "Value": "us-east-1-bos-1",
            "Version": 3,
            "LastModifiedDate": "2020-12-15T14:16:17.983000-08:00",
            "ARN": "arn:aws:ssm:us-east-2::parameter/aws/service/global-infrastructure/local-zones/use1-bos1-az1/zone-group",
            "DataType": "text"
        }
    ]
}
仅查看本地区域参数名称

您可以使用以下命令仅查看本地区域参数的名称。

Linux & macOS
aws ssm get-parameters-by-path \ --path /aws/service/global-infrastructure/local-zones/usw2-lax1-az1 \ --query 'Parameters[].Name | sort(@)'
Windows
aws ssm get-parameters-by-path ^ --path /aws/service/global-infrastructure/local-zones/use1-bos1-az1 ^ --query "Parameters[].Name | sort(@)"

此命令会返回如下信息。

[
    "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/geolocationCountry",
    "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/geolocationRegion",
    "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/location",
    "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/network-border-group",
    "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/parent-availability-zone",
    "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/parent-region",
    "/aws/service/global-infrastructure/local-zones/use1-bos1-az1/zone-group"
]