查看通道详情
功能介绍
本接口用于查询指定通道的详情。
URI
GET /v2/{project_id}/streams/{stream_name}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
stream_name |
是 |
String |
需要查询的通道名称。 最大长度:60 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
start_partitionId |
否 |
String |
从该分区值开始返回分区列表,返回的分区列表不包括此分区。 |
limit_partitions |
否 |
Integer |
单次请求返回的最大分区数。 取值范围:1~1000。 默认值:100。 最小值:1 最大值:1000 缺省值:100 |
stream_id |
否 |
String |
通道唯一标识符,在查询被授权的通道详情时必选。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
stream_name |
String |
通道名称。 |
create_time |
Long |
通道创建的时间,13位时间戳。 |
last_modified_time |
Long |
通道最近一次修改的时间,13位时间戳。 |
status |
String |
通道的当前状态。
枚举值:
|
stream_type |
String |
通道类型。
枚举值:
|
partitions |
Array of PartitionResult objects |
A list of partitions that comprise the DIS stream. |
has_more_partitions |
Boolean |
是否还有更多满足请求条件的分区。
|
retention_period |
Integer |
数据保留时长,单位是小时。 |
stream_id |
String |
通道唯一标示符。 |
data_type |
String |
源数据类型。
缺省值:BLOB。 枚举值:
|
data_schema |
String |
用于描述用户JSON、CSV格式的源数据结构,采用Avro Schema的语法描述。Avro介绍您也可以点击这里查看。 |
compression_format |
String |
数据的压缩类型,目前支持:
默认不压缩。 枚举值:
|
csv_properties |
CSVProperties object |
CSV 格式数据的相关属性,比如分隔符 delimiter |
writable_partition_count |
Integer |
可写分区总数量(只包含ACTIVE状态的分区)。 |
readable_partition_count |
Integer |
可读分区总数量(包含ACTIVE与DELETED状态的分区)。 |
update_partition_counts |
Array of UpdatePartitionCount objects |
扩缩容操作记录列表。 |
tags |
Array of Tag objects |
通道的标签列表。 |
sys_tags |
Array of SysTag objects |
通道的企业项目。 |
auto_scale_enabled |
Boolean |
是否开启自动扩缩容。
默认不开启。 |
auto_scale_min_partition_count |
Integer |
当自动扩缩容启用时,自动缩容的最小分片数。 |
auto_scale_max_partition_count |
Integer |
当自动扩缩容启用时,自动扩容的最大分片数。 |
参数 |
参数类型 |
描述 |
---|---|---|
status |
String |
分区的当前状态。
枚举值:
|
partition_id |
String |
分区的唯一标识符。 |
hash_range |
String |
分区的可能哈希键值范围。 |
sequence_number_range |
String |
分区的序列号范围。 |
parent_partitions |
String |
父分区。 |
参数 |
参数类型 |
描述 |
---|---|---|
create_timestamp |
Long |
扩缩容操作执行时间戳,13位时间戳。 |
src_partition_count |
Integer |
扩缩容操作前分区数量。 |
target_partition_count |
Integer |
扩缩容操作后分区数量。 |
result_code |
Integer |
扩缩容操作响应码。 |
result_msg |
Integer |
扩缩容操作响应信息。 |
auto_scale |
Boolean |
本次扩缩容操作是否为自动扩缩容。
|
请求示例
查看通道详情
GET https://{Endpoint}/v2/{project_id}/streams/{stream_name}
响应示例
状态码: 200
正常返回
{ "stream_id" : "8QM3Nt9YTLOwtUVYJhO", "stream_name" : "newstream", "create_time" : 1593569685875, "last_modified_time" : "1599050091026,", "retention_period" : 24, "status" : "RUNNING", "stream_type" : "COMMON", "data_type" : "BLOB", "writable_partition_count" : 1, "readable_partition_count" : 1, "tags" : [ ], "auto_scale_enabled" : false, "auto_scale_min_partition_count" : 0, "auto_scale_max_partition_count" : 0, "partitions" : [ { "status" : "ACTIVE", "partition_id" : "shardId-0000000000", "hash_range" : "[0 : 9223372036854775807]", "sequence_number_range" : "[289911 : 289927]" } ], "has_more_partitions" : false }
状态码
状态码 |
描述 |
---|---|
200 |
正常返回 |
错误码
请参见错误码。