DescribeReplicationConfigurations - Amazon Elastic File System
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

DescribeReplicationConfigurations

检索特定文件系统的复制配置。如果未指定文件系统,则会检索 Amazon Web Services 区域中所有 Amazon Web Services 账户的复制配置。

请求语法

GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

FileSystemId

可以通过提供特定文件系统的文件系统 ID 来检索其复制配置。对于跨账户、跨区域复制,账户只能描述自己所在区域中文件系统的复制配置。

长度限制:最大长度为 128。

模式:^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

MaxResults

(可选)要限制响应中返回的对象数,可以指定 MaxItems 参数。默认值是 100。

有效范围:最小值为 1。

NextToken

如果对响应进行分页,则显示 NextToken。可以在后续请求中使用 NextToken 获取下一页输出。

长度限制:长度下限为 1。最大长度为 128。

模式:.+

请求体

该请求没有请求正文。

响应语法

HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Replications": [ { "CreationTime": number, "Destinations": [ { "FileSystemId": "string", "LastReplicatedTimestamp": number, "OwnerId": "string", "Region": "string", "RoleArn": "string", "Status": "string", "StatusMessage": "string" } ], "OriginalSourceFileSystemArn": "string", "SourceFileSystemArn": "string", "SourceFileSystemId": "string", "SourceFileSystemOwnerId": "string", "SourceFileSystemRegion": "string" } ] }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

NextToken

可以在后续请求中使用上一响应中的 NextToken 来获取其他描述。

类型:字符串

长度限制:长度下限为 1。最大长度为 128。

模式:.+

Replications

返回的复制配置集合。

类型:ReplicationConfigurationDescription 对象数组

错误

BadRequest

如果请求格式错误或包含错误(例如参数值无效或缺少必填参数),则返回此内容。

ErrorCode

错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。

Message

错误消息包含错误条件的常规描述(英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件,简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。

HTTP 状态代码:400

FileSystemNotFound

如果请求者的 Amazon Web Services 账户中不存在指定的 FileSystemId 值,则返回此内容。

ErrorCode

错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。

Message

错误消息包含错误条件的常规描述(英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件,简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。

HTTP 状态代码:404

InternalServerError

如果服务器端发生错误,则返回此内容。

ErrorCode

错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。

Message

错误消息包含错误条件的常规描述(英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件,简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。

HTTP 状态代码:500

ReplicationNotFound

如果指定的文件系统没有复制配置,则返回此内容。

ErrorCode

ReplicationNotFound

Message

错误消息包含错误条件的常规描述(英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件,简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。

HTTP 状态代码:404

ValidationException

如果请求所在的 Amazon Web Services 区域不提供 Amazon Backup 服务,则返回此内容。

ErrorCode

错误代码是用于唯一标识错误条件的字符串。这意味着按类型检测和处理错误的程序将读取和理解错误代码。

Message

错误消息包含错误条件的常规描述(英语)。它主要面向用户受众。如果用户遇到不知如何处理或不愿处理的错误条件,简单的程序将直接向最终用户显示消息。支持更详尽的错误处理和适当国际化的复杂程序更容易忽略错误消息。

HTTP 状态代码:400

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: