- NAME
-
- gcloud alpha iot devices credentials create - add a new credential to a device
- SYNOPSIS
-
-
gcloud alpha iot devices credentials create
--path
=PATH
--type
=TYPE
(--device
=DEVICE
:--region
=REGION
--registry
=REGISTRY
) [--expiration-time
=EXPIRATION_TIME
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
(DEPRECATED)
Add a new credential to a device.This command is deprecated. Google Cloud IoT Core has been retired.
A device may have at most 3 credentials.
- EXAMPLES
-
To add an RSA public key wrapped in an X.509v3 certificate to a device, run:
gcloud alpha iot devices credentials create --region=us-central1 --registry=my-registry --device=my-device --path=/path/to/cert.pem --type=rsa-x509-pem
To add a public key for the ECDSA algorithm to a device, run:
gcloud alpha iot devices credentials create --region=us-central1 --registry=my-registry --device=my-device --path=/path/to/ec_public.pem --type=es256-pem
- REQUIRED FLAGS
-
--path
=PATH
- The path on disk to the file containing the key.
--type
=TYPE
-
The type of the key.
TYPE
must be one of:es256
-
Deprecated nmame for
es256-pem
es256-pem
-
Public key for the ECDSA algorithm using P-256 and SHA-256, encoded in base64,
and wrapped by
-----BEGIN PUBLIC KEY-----
and-----END PUBLIC KEY-----
. This can be used to verify JWT tokens with theES256
algorithm (RFC7518). This curve is defined in OpenSSL as theprime256v1
curve. es256-x509-pem
-
As ES256_PEM, but wrapped in an X.509v3 certificate (RFC5280), encoded in base64, and
wrapped by
-----BEGIN CERTIFICATE-----
and-----END CERTIFICATE-----
. rs256
-
Deprecated name for
rsa-x509-pem
rsa-pem
-
An RSA public key encoded in base64, and wrapped by
-----BEGIN PUBLIC KEY-----
and-----END PUBLIC KEY-----
. This can be used to verifyRS256
signatures in JWT tokens (RFC7518). rsa-x509-pem
-
As RSA_PEM, but wrapped in an X.509v3 certificate (RFC5280), encoded in base64, and
wrapped by
-----BEGIN CERTIFICATE-----
and-----END CERTIFICATE-----
.
-
Device resource - The device for which to create credentials. The arguments in
this group can be used to specify the attributes of this resource. (NOTE) Some
attributes are not given arguments in this group but can be set in other ways.
To set the
project
attribute:-
provide the argument
--device
on the command line with a fully specified name; -
provide the argument
--project
on the command line; -
set the property
core/project
.
This must be specified.
--device
=DEVICE
-
ID of the device or fully qualified identifier for the device.
To set the
device
attribute:-
provide the argument
--device
on the command line.
This flag argument must be specified if any of the other arguments in this group are specified.
-
provide the argument
--region
=REGION
-
The Cloud region for the device.
To set the
region
attribute:-
provide the argument
--device
on the command line with a fully specified name; -
provide the argument
--region
on the command line.
-
provide the argument
--registry
=REGISTRY
-
The device registry for the device.
To set the
registry
attribute:-
provide the argument
--device
on the command line with a fully specified name; -
provide the argument
--registry
on the command line.
-
provide the argument
-
provide the argument
- OPTIONAL FLAGS
-
--expiration-time
=EXPIRATION_TIME
- The expiration time for the key. See $ gcloud topic datetimes for information on time formats.
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file
,--account
,--billing-project
,--configuration
,--flags-file
,--flatten
,--format
,--help
,--impersonate-service-account
,--log-http
,--project
,--quiet
,--trace-token
,--user-output-enabled
,--verbosity
.Run
$ gcloud help
for details. - NOTES
-
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation-only early access
allowlist. These variants are also available:
gcloud iot devices credentials create
gcloud beta iot devices credentials create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-02-06 UTC.
[{
"type": "thumb-down",
"id": "hardToUnderstand",
"label":"Hard to understand"
},{
"type": "thumb-down",
"id": "incorrectInformationOrSampleCode",
"label":"Incorrect information or sample code"
},{
"type": "thumb-down",
"id": "missingTheInformationSamplesINeed",
"label":"Missing the information/samples I need"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"Other"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"Easy to understand"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"Solved my problem"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"Other"
}]