az iot central api-token

참고

이 참조는 Azure CLI 대한 azure-iot 확장의 일부이며 버전 2.17.1 이상이 필요합니다. az iot central api-token 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

IoT Central 애플리케이션에 대한 API 토큰을 관리합니다.

IoT Central 사용하면 IoT Central API에 액세스하는 데 사용할 API 토큰을 생성하고 관리할 수 있습니다. API에 대한 자세한 내용은 에서 찾을 수 https://aka.ms/iotcentraldocsapi 있습니다.

명령

az iot central api-token create

IoT Central 애플리케이션과 연결된 API 토큰을 생성합니다.

az iot central api-token delete

IoT Central 애플리케이션과 연결된 API 토큰을 삭제합니다.

az iot central api-token list

IoT Central 애플리케이션과 연결된 모든 API 토큰을 나열합니다.

az iot central api-token show

IoT Central 애플리케이션과 연결된 API 토큰에 대한 세부 정보를 얻습니다.

az iot central api-token create

IoT Central 애플리케이션과 연결된 API 토큰을 생성합니다.

참고: 토큰이 생성되면 다시 검색할 수 없도록 토큰을 적어둡니다.

az iot central api-token create --app-id
                                --role {admin, builder, operator}
                                --tkid
                                [--api-version {1.0, preview}]
                                [--central-api-uri]
                                [--token]

예제

새 API 토큰 추가

az iot central api-token create --token-id {tokenId} --app-id {appId} --role admin

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--role -r

이 토큰과 연결될 역할입니다. 기본 제공 역할 중 하나를 지정하거나 사용자 지정 역할의 역할 ID를 지정할 수 있습니다. 자세한 내용은 를 https://aka.ms/iotcentral-customrolesdocs 참조하세요.

허용되는 값: admin, builder, operator
--tkid --token-id

이 토큰과 연결된 IoT Central ID인 [0-9a-zA-Z-]가 허용되고 최대 길이 제한이 40입니다. 나중에 CLI 또는 API를 통해 이 토큰을 수정하거나 삭제할 때 사용할 ID를 지정합니다.

선택적 매개 변수

--api-version --av

요청된 작업에 대한 API 버전입니다.

허용되는 값: 1.0, preview
기본값: 1.0
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com.

기본값: azureiotcentral.com
--token

Azure CLI 대해 인증하지 않고 요청을 제출하려는 경우 요청을 인증할 유효한 사용자 토큰을 지정할 수 있습니다. 요청의 일부로 키 형식을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

az iot central api-token delete

IoT Central 애플리케이션과 연결된 API 토큰을 삭제합니다.

az iot central api-token delete --app-id
                                --tkid
                                [--api-version {1.0, preview}]
                                [--central-api-uri]
                                [--token]

예제

API 토큰 삭제

az iot central api-token delete --app-id {appid} --token-id {tokenId}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--tkid --token-id

이 토큰과 연결된 IoT Central ID인 [0-9a-zA-Z-]가 허용되고 최대 길이 제한이 40입니다. 나중에 CLI 또는 API를 통해 이 토큰을 수정하거나 삭제할 때 사용할 ID를 지정합니다.

선택적 매개 변수

--api-version --av

요청된 작업에 대한 API 버전입니다.

허용되는 값: 1.0, preview
기본값: 1.0
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com.

기본값: azureiotcentral.com
--token

Azure CLI 대해 인증하지 않고 요청을 제출하려는 경우 요청을 인증할 유효한 사용자 토큰을 지정할 수 있습니다. 요청의 일부로 키 형식을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

az iot central api-token list

IoT Central 애플리케이션과 연결된 모든 API 토큰을 나열합니다.

목록의 정보에는 애플리케이션의 토큰에 대한 기본 정보가 포함되며 토큰 값은 포함되지 않습니다.

az iot central api-token list --app-id
                              [--api-version {1.0, preview}]
                              [--central-api-uri]
                              [--token]

예제

API 토큰 목록

az iot central api-token list --app-id {appid}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

선택적 매개 변수

--api-version --av

요청된 작업에 대한 API 버전입니다.

허용되는 값: 1.0, preview
기본값: 1.0
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com.

기본값: azureiotcentral.com
--token

Azure CLI 대해 인증하지 않고 요청을 제출하려는 경우 요청을 인증할 유효한 사용자 토큰을 지정할 수 있습니다. 요청의 일부로 키 형식을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.

az iot central api-token show

IoT Central 애플리케이션과 연결된 API 토큰에 대한 세부 정보를 얻습니다.

IoT Central 앱의 API 토큰에 대한 관련 역할과 같은 세부 정보를 나열합니다.

az iot central api-token show --app-id
                              --tkid
                              [--api-version {1.0, preview}]
                              [--central-api-uri]
                              [--token]

예제

API 토큰 얻기

az iot central api-token show --app-id {appid} --token-id {tokenId}

필수 매개 변수

--app-id -n

관리하려는 IoT Central 앱의 앱 ID입니다. 도움말 메뉴 아래의 애플리케이션에 대한 "정보" 페이지에서 앱 ID를 찾을 수 있습니다.

--tkid --token-id

이 토큰과 연결된 IoT Central ID인 [0-9a-zA-Z-]가 허용되고 최대 길이 제한이 40입니다. 나중에 CLI 또는 API를 통해 이 토큰을 수정하거나 삭제할 때 사용할 ID를 지정합니다.

선택적 매개 변수

--api-version --av

요청된 작업에 대한 API 버전입니다.

허용되는 값: 1.0, preview
기본값: 1.0
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다. 기본값은 azureiotcentral.com.

기본값: azureiotcentral.com
--token

Azure CLI 대해 인증하지 않고 요청을 제출하려는 경우 요청을 인증할 유효한 사용자 토큰을 지정할 수 있습니다. 요청의 일부로 키 형식을 지정해야 합니다. https://aka.ms/iotcentraldocsapi에서 자세히 알아보세요.