Sensor Partner Integrations - List
パートナー統合モデルを取得します。
GET {endpoint}/sensor-partners/{sensorPartnerId}/integrations?api-version=2023-11-01-preview
GET {endpoint}/sensor-partners/{sensorPartnerId}/integrations?partyIds={partyIds}&ids={ids}&names={names}&propertyFilters={propertyFilters}&statuses={statuses}&minCreatedDateTime={minCreatedDateTime}&maxCreatedDateTime={maxCreatedDateTime}&minLastModifiedDateTime={minLastModifiedDateTime}&maxLastModifiedDateTime={maxLastModifiedDateTime}&maxPageSize={maxPageSize}&skipToken={skipToken}&api-version=2023-11-01-preview
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
endpoint
|
path | True |
string uri |
名前空間のホスト名 (例: admaInstanceName.farmbeats.azure.net) |
sensor
|
path | True |
string |
関連付けられているセンサー パートナーの ID。 |
api-version
|
query | True |
string |
要求された API バージョン |
ids
|
query |
string[] |
リソースの ID。 |
|
max
|
query |
string date-time |
リソースの最大作成日 (含む)。 |
|
max
|
query |
string date-time |
リソースの最終変更日 (含む)。 |
|
max
|
query |
integer int32 |
必要な項目の最大数 (含む)。 Minimum = 10、Maximum = 1000、既定値 = 50。 |
|
min
|
query |
string date-time |
リソースの最小作成日 (含む)。 |
|
min
|
query |
string date-time |
リソースの最終更新日の最小値 (含む)。 |
|
names
|
query |
string[] |
リソースの名前。 |
|
party
|
query |
string[] |
パーティの ID。 |
|
property
|
query |
string[] |
Properties オブジェクト内のキーと値のペアをフィルター処理します。 例: "{testKey} eq {testValue}"。 |
|
skip
|
query |
string |
次の結果セットを取得するためのトークンをスキップします。 |
|
statuses
|
query |
string[] |
リソースの状態。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
Authorization | True |
string |
承認された API 呼び出しに対して有効なベアラー トークンを指定してください。 以前に認証されていない呼び出しを試した場合は、ブラウザー キャッシュをクリアする必要がある場合があることに注意してください。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
Success |
|
Other Status Codes |
エラー ヘッダー x-ms-error-code: string |
セキュリティ
Authorization
承認された API 呼び出しに対して有効なベアラー トークンを指定してください。 以前に認証されていない呼び出しを試した場合は、ブラウザー キャッシュをクリアする必要がある場合があることに注意してください。
型:
apiKey
/:
header
例
SensorPartnerIntegrations_List
要求のサンプル
GET {endpoint}/sensor-partners/Davis/integrations?api-version=2023-11-01-preview
応答のサンプル
{
"value": [
{
"integrationId": "I123",
"partyId": "prbhad-party",
"sensorPartnerId": "Davis",
"id": "I123",
"status": "string",
"createdDateTime": "2021-11-22T05:07:14Z",
"modifiedDateTime": "2022-01-04T11:17:08Z",
"eTag": "8900a6d8-0000-0700-0000-61d42cb40000",
"name": "string",
"description": "string",
"properties": {
"key1": "value1",
"key2": 123.45
}
},
{
"integrationId": "I456",
"partyId": "prbhad-party2",
"sensorPartnerId": "Davis",
"id": "I456",
"status": "string",
"createdDateTime": "2022-01-12T10:33:54Z",
"modifiedDateTime": "2022-01-12T10:33:54Z",
"eTag": "8d014fe2-0000-0700-0000-61deae920000",
"name": "string",
"description": "string",
"properties": {
"key1": "value1",
"key2": 123.45
}
}
],
"skipToken": "string",
"nextLink": "https://{{resourceName}}.farmbeats.azure.net/sensor-partners/Davis/integrations?maxPageSize=10&api-version=2023-11-01-preview&skipToken=W3sidG9rZW4iOiIrUklEOn4xQ1VyQU9zRU8zMXZucGdCQUFBQUFBPT0jUlQ6MSNUUkM6MTAjSVNWOjIjSUVPOjY1NTUxI1FDRjo0I0ZQQzpBZ0ppQm1JR1lnWUVBRytlRDRBPSIsInJhbmdlIjp7Im1pbiI6IiIsIm1heCI6IkZGIn19XQ"
}
定義
名前 | 説明 |
---|---|
Error |
Azure AgPlatform サービスからのエラー。 |
Error |
Azure AgPlatform サービスからのエラー応答。 ErrorResponse リファレンス ドキュメントを参照 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses してください。 |
Inner |
エラーの一覧を含む内部エラー。InnerError リファレンス ドキュメントを参照 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object してください。 |
Sensor |
センサー パートナー統合モデル。 |
Sensor |
ページングされた応答には、要求されたオブジェクトの一覧と、次の結果セットを取得するための URL リンクが含まれています。 |
Error
Azure AgPlatform サービスからのエラー。
名前 | 型 | 説明 |
---|---|---|
code |
string |
サーバー定義のエラー コードのセット。 |
details |
Error[] |
この報告されたエラーの原因となった特定のエラーに関する詳細の配列。 |
innererror |
エラーの一覧を含む内部エラー。InnerError リファレンス ドキュメントを参照 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object してください。 |
|
message |
string |
人が判読できるエラーの表現。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
Azure AgPlatform サービスからのエラー応答。 ErrorResponse リファレンス ドキュメントを参照 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses してください。
名前 | 型 | 説明 |
---|---|---|
error |
Azure AgPlatform サービスからのエラー。 |
|
traceId |
string |
一意のトレース ID。 |
InnerError
エラーの一覧を含む内部エラー。InnerError リファレンス ドキュメントを参照 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object してください。
名前 | 型 | 説明 |
---|---|---|
code |
string |
を含むエラーによって提供されたエラー コードよりも具体的なエラー コード。 |
innererror |
エラーの一覧を含む内部エラー。InnerError リファレンス ドキュメントを参照 https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object してください。 |
SensorPartnerIntegrationModel
センサー パートナー統合モデル。
名前 | 型 | 説明 |
---|---|---|
createdBy |
string |
ユーザー/テナント ID によって作成されます。 |
createdDateTime |
string |
リソースが作成された日時 (サンプル形式: yyyy-MM-ddTHH:mm:ssZ)。 |
description |
string |
リソースの説明テキスト。 |
eTag |
string |
オプティミスティック コンカレンシーを実装する ETag 値。 |
id |
string |
リソースの ID。 |
integrationId |
string |
統合の ID。 |
modifiedBy |
string |
ユーザー/テナント ID によって変更されます。 |
modifiedDateTime |
string |
リソースが最後に変更された日時 (サンプル形式: yyyy-MM-ddTHH:mm:ssZ)。 |
name |
string |
リソースを識別する名前 |
partyId |
string |
パーティの ID。 |
properties |
リソースに属するキー値ペアのコレクション。 各ペアには、50 文字を超えるキーを持つ必要があり、150 文字を超える値を持つ必要があります。 注: リソースには最大 25 個のキー値ペアを指定でき、文字列、数字、datetime (yyyy-MM-ddTHH:mm:ssZ) 値のみがサポートされます。 |
|
sensorPartnerId |
string |
関連付けられているセンサー パートナーの ID。 |
status |
string |
リソースの状態。 |
SensorPartnerIntegrationModelListResponse
ページングされた応答には、要求されたオブジェクトの一覧と、次の結果セットを取得するための URL リンクが含まれています。
名前 | 型 | 説明 |
---|---|---|
nextLink |
string |
一覧にある結果の次のページへの継続リンク (絶対 URI) |
skipToken |
string |
次のページの取得に使用されるトークン。 null の場合、追加のページはありません。 |
value |
要求されたオブジェクトの一覧。 |