-
Notifications
You must be signed in to change notification settings - Fork 101
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[minor_change] Addition of new generated resource and data source for…
… pkiTP
- Loading branch information
Showing
41 changed files
with
3,246 additions
and
51 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,64 @@ | ||
--- | ||
# Documentation generated by "gen/generator.go"; DO NOT EDIT. | ||
# In order to regenerate this file execute `go generate` from the repository root. | ||
# More details can be found in the [README](https://github.com/CiscoDevNet/terraform-provider-aci/blob/master/README.md). | ||
subcategory: "Generic" | ||
layout: "aci" | ||
page_title: "ACI: aci_certificate_authority" | ||
sidebar_current: "docs-aci-data-source-aci_certificate_authority" | ||
description: |- | ||
Data source for Certificate Authority | ||
--- | ||
|
||
# aci_certificate_authority # | ||
|
||
Data source for Certificate Authority | ||
|
||
## API Information ## | ||
|
||
* Class: [pkiTP](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/pkiTP/overview) | ||
|
||
|
||
* Distinguished Name Formats: | ||
- `uni/tn-{name}/certstore/tp-{name}` | ||
- `uni/userext/pkiext/tp-{name}` | ||
|
||
## GUI Information ## | ||
|
||
* Location: `Generic` | ||
|
||
## Example Usage ## | ||
|
||
```hcl | ||
data "aci_certificate_authority" "example_public_key_management" { | ||
parent_dn = aci_public_key_management.example.id | ||
name = "test_name" | ||
} | ||
``` | ||
|
||
## Schema ## | ||
|
||
### Required ### | ||
|
||
* `parent_dn` - (string) The distinguished name (DN) of the parent object, possible resources: | ||
- [aci_public_key_management](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/public_key_management) ([pkiEp](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/pkiEp/overview)) | ||
- The distinquised name (DN) of classes below can be used but currently there is no available resource for it: | ||
- [cloudCertStore](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/cloudCertStore/overview) | ||
|
||
* `name` (name) - (string) The name of the Certificate Authority object. | ||
|
||
### Read-Only ### | ||
|
||
* `id` - (string) The distinguished name (DN) of the Certificate Authority object. | ||
* `annotation` (annotation) - (string) The annotation of the Certificate Authority object. | ||
* `cert_chain` (certChain) - (string) The PEM-encoded chain of trust from the trustpoint to a trusted root authority. | ||
* `description` (descr) - (string) The description of the Certificate Authority object. | ||
* `name_alias` (nameAlias) - (string) The name alias of the Certificate Authority object. | ||
* `owner_key` (ownerKey) - (string) The key for enabling clients to own their data for entity correlation. | ||
* `owner_tag` (ownerTag) - (string) A tag for enabling clients to add their own data. For example, to indicate who created this object. | ||
|
||
* `annotations` - (list) A list of Annotations objects ([tagAnnotation](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/tagAnnotation/overview)). This attribute is supported in ACI versions: 3.2(1l) and later. | ||
* `key` (key) - (string) The key used to uniquely identify this configuration object. | ||
* `value` (value) - (string) The value of the property. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,120 @@ | ||
--- | ||
# Documentation generated by "gen/generator.go"; DO NOT EDIT. | ||
# In order to regenerate this file execute `go generate` from the repository root. | ||
# More details can be found in the [README](https://github.com/CiscoDevNet/terraform-provider-aci/blob/master/README.md). | ||
subcategory: "Generic" | ||
layout: "aci" | ||
page_title: "ACI: aci_certificate_authority" | ||
sidebar_current: "docs-aci-resource-aci_certificate_authority" | ||
description: |- | ||
Manages ACI Certificate Authority | ||
--- | ||
|
||
# aci_certificate_authority # | ||
|
||
Manages ACI Certificate Authority | ||
|
||
|
||
|
||
## API Information ## | ||
|
||
* Class: [pkiTP](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/pkiTP/overview) | ||
|
||
|
||
* Distinguished Name Formats: | ||
- `uni/tn-{name}/certstore/tp-{name}` | ||
- `uni/userext/pkiext/tp-{name}` | ||
|
||
## GUI Information ## | ||
|
||
* Location: `Generic` | ||
|
||
## Example Usage ## | ||
|
||
The configuration snippet below creates a Certificate Authority with only required attributes. | ||
|
||
```hcl | ||
resource "aci_certificate_authority" "example_public_key_management" { | ||
parent_dn = "uni/userext/pkiext" | ||
cert_chain = "<<EOT -----BEGIN_CERTIFICATE----- MIICODCCAaGgAwIBAgIJAIt8XMntue0VMA0GCSqGSIb3DQEBCwUAMDQxDjAMBgNV BAMMBUFkbWluMRUwEwYDVQQKDAxZb3VyIENvbXBhbnkxCzAJBgNVBAYTAlVTMCAX DTE4MDEwOTAwNTk0NFoYDzIxMTcxMjE2MDA1OTQ0WjA0MQ4wDAYDVQQDDAVBZG1p bjEVMBMGA1UECgwMWW91ciBDb21wYW55MQswCQYDVQQGEwJVUzCBnzANBgkqhkiG 9w0BAQEFAAOBjQAwgYkCgYEAohG/7axtt7CbSaMP7r+2mhTKbNgh0Ww36C7Ta14i v+VmLyKkQHnXinKGhp6uy3Nug+15a+eIu7CrgpBVMQeCiWfsnwRocKcQJWIYDrWl XHxGQn31yYKR6mylE7Dcj3rMFybnyhezr5D8GcP85YRPmwG9H2hO/0Y1FUnWu9Iw AQkCAwEAAaNQME4wHQYDVR0OBBYEFD0jLXfpkrU/ChzRvfruRs/fy1VXMB8GA1Ud IwQYMBaAFD0jLXfpkrU/ChzRvfruRs/fy1VXMAwGA1UdEwQFMAMBAf8wDQYJKoZI hvcNAQELBQADgYEAOmvre+5tgZ0+F3DgsfxNQqLTrGiBgGCIymPkP/cBXXkNuJyl 3ac7tArHQc7WEA4U2R2rZbEq8FC3UJJm4nUVtCPvEh3G9OhN2xwYev79yt6pIn/l KU0Td2OpVyo0eLqjoX5u2G90IBWzhyjFbo+CcKMrSVKj1YOdG0E3OuiJf00= -----END_CERTIFICATE----- EOT" | ||
name = "test_name" | ||
} | ||
``` | ||
The configuration snippet below shows all possible attributes of the Certificate Authority. | ||
|
||
!> This example might not be valid configuration and is only used to show all possible attributes. | ||
|
||
```hcl | ||
resource "aci_certificate_authority" "full_example_public_key_management" { | ||
parent_dn = aci_public_key_management.example.id | ||
annotation = "annotation" | ||
cert_chain = "<<EOT -----BEGIN_CERTIFICATE----- MIICODCCAaGgAwIBAgIJAIt8XMntue0VMA0GCSqGSIb3DQEBCwUAMDQxDjAMBgNV BAMMBUFkbWluMRUwEwYDVQQKDAxZb3VyIENvbXBhbnkxCzAJBgNVBAYTAlVTMCAX DTE4MDEwOTAwNTk0NFoYDzIxMTcxMjE2MDA1OTQ0WjA0MQ4wDAYDVQQDDAVBZG1p bjEVMBMGA1UECgwMWW91ciBDb21wYW55MQswCQYDVQQGEwJVUzCBnzANBgkqhkiG 9w0BAQEFAAOBjQAwgYkCgYEAohG/7axtt7CbSaMP7r+2mhTKbNgh0Ww36C7Ta14i v+VmLyKkQHnXinKGhp6uy3Nug+15a+eIu7CrgpBVMQeCiWfsnwRocKcQJWIYDrWl XHxGQn31yYKR6mylE7Dcj3rMFybnyhezr5D8GcP85YRPmwG9H2hO/0Y1FUnWu9Iw AQkCAwEAAaNQME4wHQYDVR0OBBYEFD0jLXfpkrU/ChzRvfruRs/fy1VXMB8GA1Ud IwQYMBaAFD0jLXfpkrU/ChzRvfruRs/fy1VXMAwGA1UdEwQFMAMBAf8wDQYJKoZI hvcNAQELBQADgYEAOmvre+5tgZ0+F3DgsfxNQqLTrGiBgGCIymPkP/cBXXkNuJyl 3ac7tArHQc7WEA4U2R2rZbEq8FC3UJJm4nUVtCPvEh3G9OhN2xwYev79yt6pIn/l KU0Td2OpVyo0eLqjoX5u2G90IBWzhyjFbo+CcKMrSVKj1YOdG0E3OuiJf00= -----END_CERTIFICATE----- EOT" | ||
description = "description" | ||
name = "test_name" | ||
name_alias = "name_alias" | ||
owner_key = "owner_key" | ||
owner_tag = "owner_tag" | ||
annotations = [ | ||
{ | ||
key = "annotations_1" | ||
value = "value_1" | ||
} | ||
] | ||
} | ||
``` | ||
|
||
All examples for the Certificate Authority resource can be found in the [examples](https://github.com/CiscoDevNet/terraform-provider-aci/tree/master/examples/resources/aci_certificate_authority) folder. | ||
|
||
## Schema ## | ||
|
||
### Required ### | ||
|
||
* `parent_dn` - (string) The distinguished name (DN) of the parent object, possible resources: | ||
- [aci_public_key_management](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/public_key_management) ([pkiEp](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/pkiEp/overview)) | ||
- The distinquised name (DN) of classes below can be used but currently there is no available resource for it: | ||
- [cloudCertStore](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/cloudCertStore/overview) | ||
|
||
* `cert_chain` (certChain) - (string) The PEM-encoded chain of trust from the trustpoint to a trusted root authority. | ||
* `name` (name) - (string) The name of the Certificate Authority object. | ||
|
||
### Read-Only ### | ||
|
||
* `id` - (string) The distinguished name (DN) of the Certificate Authority object. | ||
|
||
### Optional ### | ||
|
||
* `annotation` (annotation) - (string) The annotation of the Certificate Authority object. | ||
- Default: `orchestrator:terraform` | ||
* `description` (descr) - (string) The description of the Certificate Authority object. | ||
* `name_alias` (nameAlias) - (string) The name alias of the Certificate Authority object. | ||
* `owner_key` (ownerKey) - (string) The key for enabling clients to own their data for entity correlation. | ||
* `owner_tag` (ownerTag) - (string) A tag for enabling clients to add their own data. For example, to indicate who created this object. | ||
|
||
* `annotations` - (list) A list of Annotations objects ([tagAnnotation](https://pubhub.devnetcloud.com/media/model-doc-latest/docs/app/index.html#/objects/tagAnnotation/overview)). Annotations can also be configured using a separate [aci_annotation](https://registry.terraform.io/providers/CiscoDevNet/aci/latest/docs/resources/annotation) resource. This attribute is supported in ACI versions: 3.2(1l) and later. | ||
|
||
#### Required #### | ||
|
||
* `key` (key) - (string) The key used to uniquely identify this configuration object. | ||
* `value` (value) - (string) The value of the property. | ||
|
||
## Importing | ||
|
||
An existing Certificate Authority can be [imported](https://www.terraform.io/docs/import/index.html) into this resource with its distinguished name (DN), via the following command: | ||
|
||
``` | ||
terraform import aci_certificate_authority.example_public_key_management uni/tn-{name}/certstore/tp-{name} | ||
``` | ||
|
||
Starting in Terraform version 1.5, an existing Certificate Authority can be imported | ||
using [import blocks](https://developer.hashicorp.com/terraform/language/import) via the following configuration: | ||
|
||
``` | ||
import { | ||
id = "uni/tn-{name}/certstore/tp-{name}" | ||
to = aci_certificate_authority.example_public_key_management | ||
} | ||
``` |
5 changes: 5 additions & 0 deletions
5
examples/data-sources/aci_certificate_authority/data-source.tf
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,5 @@ | ||
|
||
data "aci_certificate_authority" "example_public_key_management" { | ||
parent_dn = aci_public_key_management.example.id | ||
name = "test_name" | ||
} |
14 changes: 14 additions & 0 deletions
14
examples/data-sources/aci_certificate_authority/provider.tf
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
terraform { | ||
required_providers { | ||
aci = { | ||
source = "ciscodevnet/aci" | ||
} | ||
} | ||
} | ||
|
||
provider "aci" { | ||
username = "" | ||
password = "" | ||
url = "" | ||
insecure = true | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
terraform { | ||
required_providers { | ||
aci = { | ||
source = "ciscodevnet/aci" | ||
} | ||
} | ||
} | ||
|
||
provider "aci" { | ||
username = "" | ||
password = "" | ||
url = "" | ||
insecure = true | ||
} |
17 changes: 17 additions & 0 deletions
17
examples/resources/aci_certificate_authority/resource-all-attributes.tf
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,17 @@ | ||
|
||
resource "aci_certificate_authority" "full_example_public_key_management" { | ||
parent_dn = aci_public_key_management.example.id | ||
annotation = "annotation" | ||
cert_chain = "<<EOT -----BEGIN_CERTIFICATE----- MIICODCCAaGgAwIBAgIJAIt8XMntue0VMA0GCSqGSIb3DQEBCwUAMDQxDjAMBgNV BAMMBUFkbWluMRUwEwYDVQQKDAxZb3VyIENvbXBhbnkxCzAJBgNVBAYTAlVTMCAX DTE4MDEwOTAwNTk0NFoYDzIxMTcxMjE2MDA1OTQ0WjA0MQ4wDAYDVQQDDAVBZG1p bjEVMBMGA1UECgwMWW91ciBDb21wYW55MQswCQYDVQQGEwJVUzCBnzANBgkqhkiG 9w0BAQEFAAOBjQAwgYkCgYEAohG/7axtt7CbSaMP7r+2mhTKbNgh0Ww36C7Ta14i v+VmLyKkQHnXinKGhp6uy3Nug+15a+eIu7CrgpBVMQeCiWfsnwRocKcQJWIYDrWl XHxGQn31yYKR6mylE7Dcj3rMFybnyhezr5D8GcP85YRPmwG9H2hO/0Y1FUnWu9Iw AQkCAwEAAaNQME4wHQYDVR0OBBYEFD0jLXfpkrU/ChzRvfruRs/fy1VXMB8GA1Ud IwQYMBaAFD0jLXfpkrU/ChzRvfruRs/fy1VXMAwGA1UdEwQFMAMBAf8wDQYJKoZI hvcNAQELBQADgYEAOmvre+5tgZ0+F3DgsfxNQqLTrGiBgGCIymPkP/cBXXkNuJyl 3ac7tArHQc7WEA4U2R2rZbEq8FC3UJJm4nUVtCPvEh3G9OhN2xwYev79yt6pIn/l KU0Td2OpVyo0eLqjoX5u2G90IBWzhyjFbo+CcKMrSVKj1YOdG0E3OuiJf00= -----END_CERTIFICATE----- EOT" | ||
description = "description" | ||
name = "test_name" | ||
name_alias = "name_alias" | ||
owner_key = "owner_key" | ||
owner_tag = "owner_tag" | ||
annotations = [ | ||
{ | ||
key = "annotations_1" | ||
value = "value_1" | ||
} | ||
] | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,6 @@ | ||
|
||
resource "aci_certificate_authority" "example_public_key_management" { | ||
parent_dn = "uni/userext/pkiext" | ||
cert_chain = "<<EOT -----BEGIN_CERTIFICATE----- MIICODCCAaGgAwIBAgIJAIt8XMntue0VMA0GCSqGSIb3DQEBCwUAMDQxDjAMBgNV BAMMBUFkbWluMRUwEwYDVQQKDAxZb3VyIENvbXBhbnkxCzAJBgNVBAYTAlVTMCAX DTE4MDEwOTAwNTk0NFoYDzIxMTcxMjE2MDA1OTQ0WjA0MQ4wDAYDVQQDDAVBZG1p bjEVMBMGA1UECgwMWW91ciBDb21wYW55MQswCQYDVQQGEwJVUzCBnzANBgkqhkiG 9w0BAQEFAAOBjQAwgYkCgYEAohG/7axtt7CbSaMP7r+2mhTKbNgh0Ww36C7Ta14i v+VmLyKkQHnXinKGhp6uy3Nug+15a+eIu7CrgpBVMQeCiWfsnwRocKcQJWIYDrWl XHxGQn31yYKR6mylE7Dcj3rMFybnyhezr5D8GcP85YRPmwG9H2hO/0Y1FUnWu9Iw AQkCAwEAAaNQME4wHQYDVR0OBBYEFD0jLXfpkrU/ChzRvfruRs/fy1VXMB8GA1Ud IwQYMBaAFD0jLXfpkrU/ChzRvfruRs/fy1VXMAwGA1UdEwQFMAMBAf8wDQYJKoZI hvcNAQELBQADgYEAOmvre+5tgZ0+F3DgsfxNQqLTrGiBgGCIymPkP/cBXXkNuJyl 3ac7tArHQc7WEA4U2R2rZbEq8FC3UJJm4nUVtCPvEh3G9OhN2xwYev79yt6pIn/l KU0Td2OpVyo0eLqjoX5u2G90IBWzhyjFbo+CcKMrSVKj1YOdG0E3OuiJf00= -----END_CERTIFICATE----- EOT" | ||
name = "test_name" | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.