調用DescribeCameras獲取已創建的視頻點位信息。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 DescribeCameras

系統規定參數。取值：DescribeCameras。

InstanceId String 是 cityvisual-InstanceId

實例ID。
PageNumber Integer 是 1

視頻點位列表的頁碼。起始值：1。

默認值：1 。

PageSize Integer 是 10

分頁查詢時設置的每頁行數。最大值：100。

默認值：10。

CameraId String 否 003_2

視頻點位ID。
CameraName String 否 name

視頻點位名稱。
RegionId String 否 cn-shanghai

地域ID。
StreamStatus String 否 ON_LINE

視頻點位狀態：

  • ON_LINE: 在線
  • OFF_LINE: 離線
WorkGroupId String 否 283

接流工作組ID。

返回數據

名稱 類型 示例值 描述
Cameras

視頻點位信息。
CameraId String 003_2

攝像頭ID。
CameraName String name

視頻點位名稱。
Conf String {"shardId":"0","storageType":"mq","readType":"file2ts","mediaType":"mp4","outputFormat":"raw"}

視頻點位配置信息。
InviteUri String 002_1

視頻點位GUID。
Location String {"latitude":"1.1","longitude":"2.2"}

視頻點位經緯度坐標。
RtmpPath String rtmp://IP/mylive/002_1

視頻流地址。
StreamStatus String ON_LINE

視頻點位狀態：

  • ON_LINE：在線
  • OFF_LINE：離線
UpdateTime String 2018-10-10T10:30:30Z

視頻點位更新時間。

按照ISO8601標準表示，并需要使用UTC時間，格式為yyyy-MM-ddTHH:mm:ssZ。

WorkGroupId String 637

工作組的ID。
PageNumber Integer 1

視頻點位列表的頁碼。起始值：1。

默認值：1 。
PageSize Integer 10

分頁查詢時設置的每頁行數。最大值：100。

默認值：10。
RequestId String E175B041-75A2-4335-B3AC-0FD008F93627

請求ID。
TotalCount Integer 300

該實例下的視頻點位總數。

示例

請求示例


http(s)://[Endpoint]/?Action=DescribeCameras
&InstanceId=cityvisual-InstanceId
&PageNumber=1
&PageSize=10
&<公共請求參數>

正常返回示例

XML 格式 

<DescribeCamerasResponse>
    <PageNumber>1</PageNumber>
    <TotalCount>20</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>14A07460-EBE7-47CA-9757-12CC4761D47A</RequestId>
    <Cameras>
        <Camera>
            <CameraId>003_2</CameraId>
            <Conf>{"shardId":"0","storageType":"mq","readType":"file2ts","mediaType":"mp4","outputFormat":"raw"}</Conf>
            <Id>51</Id>
            <InviteUri>003_2</InviteUri>
            <Location>{"latitude":"1.1","longitude":"2.2"}</Location>
            <Name>002_1</Name>
            <RtmpPath>rtmp://IP/mylive/002_1</RtmpPath>
            <UpdationTime>2015-07-27T07:08Z</UpdationTime>
            <StreamStatus>ON_LINE</StreamStatus>
        </Camera>
    </Cameras>
</DescribeCamerasResponse>

JSON 格式 

{
	"PageNumber":"1",
	"TotalCount":"1",
	"PageSize":"10",
	"Cameras":{
		"Camera":[
			{
				"Name":"002_1",
				"Conf":"{\"shardId\":\"0\",\"storageType\":\"mq\",\"readType\":\"file2ts\",\"mediaType\":\"mp4\",\"outputFormat\":\"raw\"}",
				"CameraId":"003_2",
				"UpdationTime":"2017-12-10T04:04Z",
				"Location":"{\"latitude\":\"1.1\",\"longitude\":\"2.2\"}",
				"Id":"51",
				"RtmpPath":"rtmp://IP/mylive/002_1",
				"InviteUri":"003_2",
				"StreamStatus":"ON_LINE"
			}
		]
	},
	"RequestId":"14A07460-EBE7-47CA-9757-12CC4761D47A"
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
404 InvalidStreamStatus.NotFound The specified StreamStatus does not exist. 指定的StreamStatus不存在。

訪問錯誤中心查看更多錯誤碼。