az iot central api-token

참고

이 참조는 Azure CLI(버전 2.30.0 이상)에 대한 azure-iot 확장의 일부입니다. 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
                                --tkid
                                [--api-version {2022-06-30-preview, 2022-07-31}]
                                [--central-api-uri]
                                [--org-id]
                                [--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알아보세요.

--tkid --token-id

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

선택적 매개 변수

--api-version --av

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31
기본값: 2022-07-31
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

기본값: azureiotcentral.com
--org-id --organization-id

토큰 역할 할당에 대한 조직의 ID입니다. api-version == 1.1-preview에만 사용할 수 있습니다.

--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 {2022-06-30-preview, 2022-07-31}]
                                [--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

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31
기본값: 2022-07-31
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

기본값: 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 {2022-06-30-preview, 2022-07-31}]
                              [--central-api-uri]
                              [--token]

예제

API 토큰 목록

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

필수 매개 변수

--app-id -n

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

선택적 매개 변수

--api-version --av

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31
기본값: 2022-07-31
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

기본값: 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 {2022-06-30-preview, 2022-07-31}]
                              [--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

이 명령 매개 변수는 더 이상 사용되지 않으며 무시됩니다. 이후 릴리스에서는 최신 GA 버전의 IoT Central API만 지원합니다. API가 아직 GA가 아닌 경우 최신 미리 보기 버전을 호출합니다.

허용되는 값: 2022-06-30-preview, 2022-07-31
기본값: 2022-07-31
--central-api-uri --central-dns-suffix

애플리케이션과 연결된 IoT Central DNS 접미사입니다.

기본값: azureiotcentral.com
--token

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