Deployments - Create Or Update Deployment

서비스:: Device Update

API 버전:: 2020-09-01

배포를 만들거나 업데이트합니다.

PUT https://{accountEndpoint}/deviceupdate/{instanceId}/v2/management/deployments/{deploymentId}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
accountEndpoint	path	True	string	계정 엔드포인트.
deploymentId	path	True	string	배포 식별자입니다.
instanceId	path	True	string	계정 인스턴스 식별자입니다.

요청 본문

Name	필수	형식	Description
deploymentId	True	string	배포 식별자를 가져오거나 설정합니다.
deploymentType	True	DeploymentType	배포 유형을 가져오거나 설정합니다.
deviceGroupDefinition	True	string[]	디바이스 그룹 정의를 가져오거나 설정합니다.
deviceGroupType	True	DeviceGroupType	디바이스 그룹 유형을 가져오거나 설정합니다.
startDateTime	True	string (date-time)	배포 시작 날짜/시간을 가져오거나 설정합니다.
updateId	True	UpdateId	ID를 업데이트합니다.
deviceClassId		string	디바이스 클래스 식별자를 가져오거나 설정합니다.
isCanceled		boolean	배포가 취소되었는지 여부를 나타내는 부울 플래그입니다.
isCompleted		boolean	배포가 완료되었는지 여부를 나타내는 부울 플래그입니다.
isRetried		boolean	배포가 다시 시도되었는지 여부를 나타내는 부울 플래그입니다.

응답

Name	형식	Description
200 OK	Deployment	배포 속성입니다.
404 Not Found		찾을 수 없습니다.

보안

azure_auth_implicit

Azure Active Directory OAuth2 암시적 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

azure_auth_code

Azure Active Directory OAuth2 AccessCode 흐름

형식: oauth2
Flow: accessCode
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/v2.0/authorize
토큰 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

범위

Name	Description
user_impersonation	사용자 계정 가장

azure_auth_application

Azure Active Directory OAuth2 애플리케이션 흐름

형식: oauth2
Flow: application
토큰 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

범위

Name	Description
.default	클라이언트 자격 증명 범위

azure_auth_password

Azure Active Directory OAuth2 암호 흐름

형식: oauth2
Flow: password
토큰 URL: https://login.microsoftonline.com/common/oauth2/v2.0/token

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Deployments_CreateOrUpdateDeployment

샘플 요청

HTTP

PUT https://contoso.api.adu.microsoft.com/deviceupdate/blue/v2/management/deployments/deploymentId

{
  "deploymentId": "deploymentId",
  "deploymentType": "Complete",
  "deviceClassId": "31ee8c56559847429fbe86e3e87f99b6",
  "startDateTime": "2020-04-22T12:12:12.0000000+00:00",
  "deviceGroupType": "Devices",
  "deviceGroupDefinition": [
    "device1",
    "device2"
  ],
  "updateId": {
    "provider": "provider",
    "name": "name",
    "version": "1.2.3.4"
  }
}

샘플 응답

상태 코드:: 200

{
  "deploymentId": "deploymentId",
  "deploymentType": "Complete",
  "deviceClassId": "31ee8c56559847429fbe86e3e87f99b6",
  "startDateTime": "2020-04-22T12:12:12.0000000+00:00",
  "deviceGroupType": "Devices",
  "deviceGroupDefinition": [
    "device1",
    "device2"
  ],
  "updateId": {
    "provider": "provider",
    "name": "name",
    "version": "1.2.3.4"
  }
}

상태 코드:: 404

정의

Name	Description
Deployment	배포 메타데이터.
DeploymentType	지원되는 배포 유형입니다.
DeviceGroupType	지원되는 배포 그룹 유형입니다.
UpdateId	업데이트 식별자입니다.

Deployment

Object

배포 메타데이터.

Name	형식	Description
deploymentId	string	배포 식별자를 가져오거나 설정합니다.
deploymentType	DeploymentType	배포 유형을 가져오거나 설정합니다.
deviceClassId	string	디바이스 클래스 식별자를 가져오거나 설정합니다.
deviceGroupDefinition	string[]	디바이스 그룹 정의를 가져오거나 설정합니다.
deviceGroupType	DeviceGroupType	디바이스 그룹 유형을 가져오거나 설정합니다.
isCanceled	boolean	배포가 취소되었는지 여부를 나타내는 부울 플래그입니다.
isCompleted	boolean	배포가 완료되었는지 여부를 나타내는 부울 플래그입니다.
isRetried	boolean	배포가 다시 시도되었는지 여부를 나타내는 부울 플래그입니다.
startDateTime	string (date-time)	배포 시작 날짜/시간을 가져오거나 설정합니다.
updateId	UpdateId	ID를 업데이트합니다.

DeploymentType

열거형

지원되는 배포 유형입니다.

값	Description
Complete	다운로드, 설치 및 적용 작업을 포함한 전체 배포입니다.
Download	설치 또는 적용 작업이 포함되지 않은 다운로드 전용 배포입니다. 현재 지원되지 않습니다.
Install	다운로드 작업을 포함하지 않고 설치 및 완료만 하는 설치 전용 롤아웃입니다. 현재 지원되지 않습니다.

DeviceGroupType

열거형

지원되는 배포 그룹 유형입니다.

값	Description
All	배포는 디바이스 클래스의 모든 디바이스로 전송되어야 합니다.
Devices	배포는 디바이스 그룹 정의의 디바이스 목록으로 전송되어야 합니다.
DeviceGroupDefinitions	배포는 모든 디바이스 그룹 정의 쿼리의 합집합에 의해 반환된 디바이스 목록으로 전송되어야 합니다.

UpdateId

Object

업데이트 식별자입니다.

Name	형식	Description
name	string	이름을 업데이트합니다.
provider	string	공급자를 업데이트합니다.
version	string	버전을 업데이트합니다.