doc.go

/*
Package secrets manages and retrieves secrets in the OpenStack Key Manager
Service.

Example to List Secrets

	createdQuery := &secrets.DateQuery{
		Date:   time.Date(2049, 6, 7, 1, 2, 3, 0, time.UTC),
		Filter: secrets.DateFilterLT,
	}

	listOpts := secrets.ListOpts{
		CreatedQuery: createdQuery,
	}

	allPages, err := secrets.List(client, listOpts).AllPages()
	if err != nil {
		panic(err)
	}

	allSecrets, err := secrets.ExtractSecrets(allPages)
	if err != nil {
		panic(err)
	}

	for _, v := range allSecrets {
		fmt.Printf("%v\n", v)
	}

Example to Get a Secret

	secret, err := secrets.Get(client, secretID).Extract()
	if err != nil {
		panic(err)
	}

	fmt.Printf("%v\n", secret)

Example to Get a Payload

	// if "Extract" method is not called, the HTTP connection will remain consumed
	payload, err := secrets.GetPayload(client, secretID).Extract()
	if err != nil {
		panic(err)
	}

	fmt.Println(string(payload))

Example to Create a Secrets

	createOpts := secrets.CreateOpts{
		Algorithm:         "aes",
		BitLength:          256,
		Mode:               "cbc",
		Name:               "mysecret",
		Payload:            "super-secret",
		PayloadContentType: "text/plain",
		SecretType:         secrets.OpaqueSecret,
	}

	secret, err := secrets.Create(client, createOpts).Extract()
	if err != nil {
		panic(err)
	}

	fmt.Println(secret.SecretRef)

Example to Add a Payload

	updateOpts := secrets.UpdateOpts{
		ContentType: "text/plain",
		Payload:     "super-secret",
	}

	err := secrets.Update(client, secretID, updateOpts).ExtractErr()
	if err != nil {
		panic(err)
	}

Example to Delete a Secrets

	err := secrets.Delete(client, secretID).ExtractErr()
	if err != nil {
		panic(err)
	}

Example to Create Metadata for a Secret

	createOpts := secrets.MetadataOpts{
		"foo":       "bar",
		"something": "something else",
	}

	ref, err := secrets.CreateMetadata(client, secretID, createOpts).Extract()
	if err != nil {
		panic(err)
	}

	fmt.Printf("%v\n", ref)

Example to Get Metadata for a Secret

	metadata, err := secrets.GetMetadata(client, secretID).Extract()
	if err != nil {
		panic(err)
	}

	fmt.Printf("%v\n", metadata)

Example to Add Metadata to a Secret

	metadatumOpts := secrets.MetadatumOpts{
		Key:   "foo",
		Value: "bar",
	}

	err := secrets.CreateMetadatum(client, secretID, metadatumOpts).ExtractErr()
	if err != nil {
		panic(err)
	}

Example to Update Metadata of a Secret

	metadatumOpts := secrets.MetadatumOpts{
		Key:   "foo",
		Value: "bar",
	}

	metadatum, err := secrets.UpdateMetadatum(client, secretID, metadatumOpts).Extract()
	if err != nil {
		panic(err)
	}

	fmt.Printf("%v\n", metadatum)

Example to Delete Metadata of a Secret

	err := secrets.DeleteMetadatum(client, secretID, "foo").ExtractErr()
	if err != nil {
		panic(err)
	}
*/
package secrets