使用 AWS CLI 的 chime get-phone-number-order 查询 Chime 电话号码订单详情【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli导读aws chime get-phone-number-order是 AWS CLI 中用于查询 Amazon Chime 电话号码订单详情的命令它通过订单 IDPhoneNumberOrderId读取订单的创建/更新时间、产品类型、订单整体状态以及订单内每个电话号码的 E.164 号码与个体状态。本指南以 awscli/examples/chime/get-phone-number-order.rst 中的官方示例为骨架结合当前仓库中 chime 服务的 botocore 模型 深入讲解命令的调用方式、返回字段含义、状态枚举与异常处理并串联create-phone-number-order与list-phone-number-orders形成完整的订单生命周期管理方案。命令基本用法get-phone-number-order只接收一个必需参数--phone-number-order-id用于指定要查询的电话号码订单 ID。命令会向服务端发送一次GET /phone-number-orders/{phoneNumberOrderId}请求对应模型 GetPhoneNumberOrder 操作并返回该订单的完整详情。官方示例来源 get-phone-number-order.rstaws chime get-phone-number-order \ --phone-number-order-id abc12345-de67-89f0-123g-h45i678j9012参数--phone-number-order-id的校验规则从请求模型GetPhoneNumberOrderRequest见 service-2.json可以看出PhoneNumberOrderId是必填字段required: [PhoneNumberOrderId]该 ID 属于GuidString类型正则模式为[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}即标准的 8-4-4-4-12 形式 UUID/GUID示例中的abc12345-de67-89f0-123g-h45i678j9012即符合此模式该参数被标记为location: urilocationName为phoneNumberOrderId这意味着它会直接拼接到请求 URI 的路径段中而非作为查询字符串或请求体字段。从源码结构看botocore 会依据该模型在序列化阶段自动完成 URL 路径参数替换、输入校验必填与正则模式以及响应解析因此命令行层面通常不需要手动处理请求格式。返回结果字段详解执行上述命令后服务端返回 HTTP 200 响应其响应体结构GetPhoneNumberOrderResponse仅包含一个成员PhoneNumberOrder类型为PhoneNumberOrder结构体。示例输出如下来源 get-phone-number-order.rst{ PhoneNumberOrder: { PhoneNumberOrderId: abc12345-de67-89f0-123g-h45i678j9012, ProductType: VoiceConnector, Status: Partial, OrderedPhoneNumbers: [ { E164PhoneNumber: 12065550100, Status: Acquired }, { E164PhoneNumber: 12065550101, Status: Acquired }, { E164PhoneNumber: 12065550102, Status: Failed } ], CreatedTimestamp: 2019-08-09T21:35:21.427Z, UpdatedTimestamp: 2019-08-09T21:35:31.926Z } }PhoneNumberOrder结构体各字段含义依据 service-2.json 中PhoneNumberOrder结构的定义各字段如下字段类型含义PhoneNumberOrderIdGuidString电话号码订单 ID与请求参数一致ProductTypePhoneNumberProductType枚举订单对应的产品类型StatusPhoneNumberOrderStatus枚举订单整体状态OrderedPhoneNumbersOrderedPhoneNumberList订单内各电话号码的详情列表CreatedTimestampIso8601Timestamp订单创建时间ISO 8601 格式即 UTC 时间戳示例中为2019-08-09T21:35:21.427ZUpdatedTimestampIso8601Timestamp订单最近更新时间示例中为2019-08-09T21:35:31.926Z晚于创建时间约 10 秒说明订单状态在该时间点发生了更新ProductType的合法取值ProductType对应PhoneNumberProductType枚举合法取值包括BusinessCalling— 商务呼叫Business Calling产品VoiceConnector— Voice Connector 产品SipMediaApplicationDialIn— SIP 媒体应用拨入产品。示例输出中的ProductType: VoiceConnector即来自该枚举。订单整体状态Status订单级别状态对应PhoneNumberOrderStatus枚举共四种Processing— 订单正在处理中Successful— 订单全部成功Failed— 订单失败Partial— 部分成功部分电话号码已获取、部分失败。示例输出中的Status: Partial表示该订单内电话号码并未全部获取成功与下方OrderedPhoneNumbers中两个Acquired、一个Failed的个体状态相互印证。个体电话号码状态OrderedPhoneNumbers[].StatusOrderedPhoneNumbers中的每个元素为OrderedPhoneNumber结构包含两个字段字段含义E164PhoneNumber电话号码E.164 格式模型 pattern 为^\?[1-9]\d{1,14}$且被标记为sensitive: true敏感字段Status个体号码状态对应OrderedPhoneNumberStatus枚举Processing处理中、Acquired已获取、Failed失败订单生命周期从创建到查询get-phone-number-order通常用于轮询或复核一个已提交订单的最终结果。整个流程可以通过关联的三个命令串联起来相关示例见 examples/chime 目录1. 创建订单create-phone-number-order通过 create-phone-number-order.rst 中的示例创建订单指定产品类型与 E.164 电话号码列表请求路径为POST /phone-number-ordersaws chime create-phone-number-order \ --product-type VoiceConnector \ --e164-phone-numbers 12065550100 12065550101 12065550102创建成功后订单状态为ProcessingOrderedPhoneNumbers中的每个号码状态也均为Processing并返回PhoneNumberOrderId供后续查询使用。2. 查询详情get-phone-number-order将上一步返回的PhoneNumberOrderId传入本命令即可查询该订单的最新状态。经过约 10 秒的处理对比两个时间戳订单整体状态变为Partial其中两个号码Acquired、一个号码Failed——这正是本指南核心命令的典型应用场景确认哪些号码已成功获取、哪些失败。3. 批量浏览list-phone-number-orders当需要查看当前 Chime 管理员账号下所有订单时可执行 list-phone-number-orders.rst 中的命令aws chime list-phone-number-orders其请求路径为GET /phone-number-orders返回PhoneNumberOrders数组每个元素与get-phone-number-order返回的PhoneNumberOrder结构相同注意当前仓库 paginators-1.json 中并未为ListPhoneNumberOrders声明分页器botocore 仅对ListAccounts、ListUsers提供分页支持因此大批量场景下建议通过多次调用或结合其他条件筛选处理。异常与错误处理依据 GetPhoneNumberOrder 操作 的错误声明该命令可能抛出以下异常括号内为对应 HTTP 状态码异常HTTP 状态码说明BadRequestException400输入参数不符合服务限制例如订单 ID 格式不合法UnauthorizedClientException401客户端当前未被授权发起请求ForbiddenException403客户端被永久禁止发起请求NotFoundException404指定订单 ID 不存在例如订单 ID 拼写错误或订单已过期删除ThrottledClientException429客户端请求频率超出限制应放慢轮询节奏ServiceFailureException500服务端遇到意外错误ServiceUnavailableException503服务当前不可用在实际脚本中最常见的两类错误是NotFoundException订单 ID 不存在通常由 ID 输入错误导致与ThrottledClientException轮询过于频繁。建议在自动化轮询脚本中对ThrottledClientException采用指数退避exponential backoff重试策略避免触发限流。在脚本中落地轮询订单结果结合上述内容一个实用的落地模式是创建订单后用返回的PhoneNumberOrderId循环调用get-phone-number-order直到订单状态不再为Processing即变为Successful、Failed或Partial再根据OrderedPhoneNumbers[].Status分别统计成功与失败的号码。示例伪代码思路如下ORDER_IDabc12345-de67-89f0-123g-h45i678j9012 while :; do STATUS$(aws chime get-phone-number-order \ --phone-number-order-id $ORDER_ID \ --query PhoneNumberOrder.Status \ --output text) echo 当前订单状态: $STATUS if [ $STATUS ! Processing ]; then break fi sleep 10 done脚本退出循环后可进一步使用--query PhoneNumberOrder.OrderedPhoneNumbers[?StatusFailed]等 JMESPath 表达式过滤失败的号码进行人工介入处理。命令支持的输出格式json/text/table由 AWS CLI 通用的 formatter 机制提供--query参数同样适用便于直接嵌入 Shell 脚本或 CI/CD 流程。小结aws chime get-phone-number-order是查询 Amazon Chime 电话号码订单详情的唯一入口命令核心要点可归纳为唯一必需参数--phone-number-order-id必须是符合8-4-4-4-12模式的 GUID 字符串返回核心结构PhoneNumberOrder包含产品类型、订单整体状态、个体号码E.164 格式 状态及 ISO 8601 时间戳状态语义订单级状态有Processing/Successful/Failed/Partial四种个体号码状态有Processing/Acquired/Failed三种二者需结合解读实践定位与create-phone-number-order、list-phone-number-orders配合即可覆盖创建 → 查询 → 复核的完整订单生命周期适合在自动化脚本中做状态轮询与失败号码筛选。所有命令与字段定义均可在当前仓库的 chime 服务模型 及 examples/chime 示例目录中查阅与验证。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
使用 AWS CLI 的 chime get-phone-number-order 查询 Chime 电话号码订单详情【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli导读aws chime get-phone-number-order是 AWS CLI 中用于查询 Amazon Chime 电话号码订单详情的命令它通过订单 IDPhoneNumberOrderId读取订单的创建/更新时间、产品类型、订单整体状态以及订单内每个电话号码的 E.164 号码与个体状态。本指南以 awscli/examples/chime/get-phone-number-order.rst 中的官方示例为骨架结合当前仓库中 chime 服务的 botocore 模型 深入讲解命令的调用方式、返回字段含义、状态枚举与异常处理并串联create-phone-number-order与list-phone-number-orders形成完整的订单生命周期管理方案。命令基本用法get-phone-number-order只接收一个必需参数--phone-number-order-id用于指定要查询的电话号码订单 ID。命令会向服务端发送一次GET /phone-number-orders/{phoneNumberOrderId}请求对应模型 GetPhoneNumberOrder 操作并返回该订单的完整详情。官方示例来源 get-phone-number-order.rstaws chime get-phone-number-order \ --phone-number-order-id abc12345-de67-89f0-123g-h45i678j9012参数--phone-number-order-id的校验规则从请求模型GetPhoneNumberOrderRequest见 service-2.json可以看出PhoneNumberOrderId是必填字段required: [PhoneNumberOrderId]该 ID 属于GuidString类型正则模式为[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}即标准的 8-4-4-4-12 形式 UUID/GUID示例中的abc12345-de67-89f0-123g-h45i678j9012即符合此模式该参数被标记为location: urilocationName为phoneNumberOrderId这意味着它会直接拼接到请求 URI 的路径段中而非作为查询字符串或请求体字段。从源码结构看botocore 会依据该模型在序列化阶段自动完成 URL 路径参数替换、输入校验必填与正则模式以及响应解析因此命令行层面通常不需要手动处理请求格式。返回结果字段详解执行上述命令后服务端返回 HTTP 200 响应其响应体结构GetPhoneNumberOrderResponse仅包含一个成员PhoneNumberOrder类型为PhoneNumberOrder结构体。示例输出如下来源 get-phone-number-order.rst{ PhoneNumberOrder: { PhoneNumberOrderId: abc12345-de67-89f0-123g-h45i678j9012, ProductType: VoiceConnector, Status: Partial, OrderedPhoneNumbers: [ { E164PhoneNumber: 12065550100, Status: Acquired }, { E164PhoneNumber: 12065550101, Status: Acquired }, { E164PhoneNumber: 12065550102, Status: Failed } ], CreatedTimestamp: 2019-08-09T21:35:21.427Z, UpdatedTimestamp: 2019-08-09T21:35:31.926Z } }PhoneNumberOrder结构体各字段含义依据 service-2.json 中PhoneNumberOrder结构的定义各字段如下字段类型含义PhoneNumberOrderIdGuidString电话号码订单 ID与请求参数一致ProductTypePhoneNumberProductType枚举订单对应的产品类型StatusPhoneNumberOrderStatus枚举订单整体状态OrderedPhoneNumbersOrderedPhoneNumberList订单内各电话号码的详情列表CreatedTimestampIso8601Timestamp订单创建时间ISO 8601 格式即 UTC 时间戳示例中为2019-08-09T21:35:21.427ZUpdatedTimestampIso8601Timestamp订单最近更新时间示例中为2019-08-09T21:35:31.926Z晚于创建时间约 10 秒说明订单状态在该时间点发生了更新ProductType的合法取值ProductType对应PhoneNumberProductType枚举合法取值包括BusinessCalling— 商务呼叫Business Calling产品VoiceConnector— Voice Connector 产品SipMediaApplicationDialIn— SIP 媒体应用拨入产品。示例输出中的ProductType: VoiceConnector即来自该枚举。订单整体状态Status订单级别状态对应PhoneNumberOrderStatus枚举共四种Processing— 订单正在处理中Successful— 订单全部成功Failed— 订单失败Partial— 部分成功部分电话号码已获取、部分失败。示例输出中的Status: Partial表示该订单内电话号码并未全部获取成功与下方OrderedPhoneNumbers中两个Acquired、一个Failed的个体状态相互印证。个体电话号码状态OrderedPhoneNumbers[].StatusOrderedPhoneNumbers中的每个元素为OrderedPhoneNumber结构包含两个字段字段含义E164PhoneNumber电话号码E.164 格式模型 pattern 为^\?[1-9]\d{1,14}$且被标记为sensitive: true敏感字段Status个体号码状态对应OrderedPhoneNumberStatus枚举Processing处理中、Acquired已获取、Failed失败订单生命周期从创建到查询get-phone-number-order通常用于轮询或复核一个已提交订单的最终结果。整个流程可以通过关联的三个命令串联起来相关示例见 examples/chime 目录1. 创建订单create-phone-number-order通过 create-phone-number-order.rst 中的示例创建订单指定产品类型与 E.164 电话号码列表请求路径为POST /phone-number-ordersaws chime create-phone-number-order \ --product-type VoiceConnector \ --e164-phone-numbers 12065550100 12065550101 12065550102创建成功后订单状态为ProcessingOrderedPhoneNumbers中的每个号码状态也均为Processing并返回PhoneNumberOrderId供后续查询使用。2. 查询详情get-phone-number-order将上一步返回的PhoneNumberOrderId传入本命令即可查询该订单的最新状态。经过约 10 秒的处理对比两个时间戳订单整体状态变为Partial其中两个号码Acquired、一个号码Failed——这正是本指南核心命令的典型应用场景确认哪些号码已成功获取、哪些失败。3. 批量浏览list-phone-number-orders当需要查看当前 Chime 管理员账号下所有订单时可执行 list-phone-number-orders.rst 中的命令aws chime list-phone-number-orders其请求路径为GET /phone-number-orders返回PhoneNumberOrders数组每个元素与get-phone-number-order返回的PhoneNumberOrder结构相同注意当前仓库 paginators-1.json 中并未为ListPhoneNumberOrders声明分页器botocore 仅对ListAccounts、ListUsers提供分页支持因此大批量场景下建议通过多次调用或结合其他条件筛选处理。异常与错误处理依据 GetPhoneNumberOrder 操作 的错误声明该命令可能抛出以下异常括号内为对应 HTTP 状态码异常HTTP 状态码说明BadRequestException400输入参数不符合服务限制例如订单 ID 格式不合法UnauthorizedClientException401客户端当前未被授权发起请求ForbiddenException403客户端被永久禁止发起请求NotFoundException404指定订单 ID 不存在例如订单 ID 拼写错误或订单已过期删除ThrottledClientException429客户端请求频率超出限制应放慢轮询节奏ServiceFailureException500服务端遇到意外错误ServiceUnavailableException503服务当前不可用在实际脚本中最常见的两类错误是NotFoundException订单 ID 不存在通常由 ID 输入错误导致与ThrottledClientException轮询过于频繁。建议在自动化轮询脚本中对ThrottledClientException采用指数退避exponential backoff重试策略避免触发限流。在脚本中落地轮询订单结果结合上述内容一个实用的落地模式是创建订单后用返回的PhoneNumberOrderId循环调用get-phone-number-order直到订单状态不再为Processing即变为Successful、Failed或Partial再根据OrderedPhoneNumbers[].Status分别统计成功与失败的号码。示例伪代码思路如下ORDER_IDabc12345-de67-89f0-123g-h45i678j9012 while :; do STATUS$(aws chime get-phone-number-order \ --phone-number-order-id $ORDER_ID \ --query PhoneNumberOrder.Status \ --output text) echo 当前订单状态: $STATUS if [ $STATUS ! Processing ]; then break fi sleep 10 done脚本退出循环后可进一步使用--query PhoneNumberOrder.OrderedPhoneNumbers[?StatusFailed]等 JMESPath 表达式过滤失败的号码进行人工介入处理。命令支持的输出格式json/text/table由 AWS CLI 通用的 formatter 机制提供--query参数同样适用便于直接嵌入 Shell 脚本或 CI/CD 流程。小结aws chime get-phone-number-order是查询 Amazon Chime 电话号码订单详情的唯一入口命令核心要点可归纳为唯一必需参数--phone-number-order-id必须是符合8-4-4-4-12模式的 GUID 字符串返回核心结构PhoneNumberOrder包含产品类型、订单整体状态、个体号码E.164 格式 状态及 ISO 8601 时间戳状态语义订单级状态有Processing/Successful/Failed/Partial四种个体号码状态有Processing/Acquired/Failed三种二者需结合解读实践定位与create-phone-number-order、list-phone-number-orders配合即可覆盖创建 → 查询 → 复核的完整订单生命周期适合在自动化脚本中做状态轮询与失败号码筛选。所有命令与字段定义均可在当前仓库的 chime 服务模型 及 examples/chime 示例目录中查阅与验证。【免费下载链接】aws-cliUniversal Command Line Interface for Amazon Web Services项目地址: https://gitcode.com/GitHub_Trending/aw/aws-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
