SCALRCORE-21783 Add AccessTokens.Read method

Author: petroprotsakh

access_token.go

@@ -14,6 +14,7 @@ var _ AccessTokens = (*accessTokens)(nil)
 // AccessTokens describes all the access token related methods that the
 // Scalr IACP API supports.
 type AccessTokens interface {
+	Read(ctx context.Context, accessTokenID string) (*AccessToken, error)
 	Update(ctx context.Context, accessTokenID string, options AccessTokenUpdateOptions) (*AccessToken, error)
 	Delete(ctx context.Context, accessTokenID string) error
 }
@@ -58,6 +59,27 @@ type AccessTokenUpdateOptions struct {
 	Description *string `jsonapi:"attr,description,omitempty"`
 }
 
+// Read access token by its ID
+func (s *accessTokens) Read(ctx context.Context, accessTokenID string) (*AccessToken, error) {
+	if !validStringID(&accessTokenID) {
+		return nil, errors.New("invalid value for access token ID")
+	}
+
+	u := fmt.Sprintf("access-tokens/%s", url.QueryEscape(accessTokenID))
+	req, err := s.client.newRequest("GET", u, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	at := &AccessToken{}
+	err = s.client.do(ctx, req, at)
+	if err != nil {
+		return nil, err
+	}
+
+	return at, nil
+}
+
 // Update is used to update an AccessToken.
 func (s *accessTokens) Update(ctx context.Context, accessTokenID string, options AccessTokenUpdateOptions) (*AccessToken, error) {
 

access_token_test.go

@@ -9,6 +9,33 @@ import (
 	"github.com/stretchr/testify/require"
 )
 
+func TestAccessTokenRead(t *testing.T) {
+	client := testClient(t)
+	ctx := context.Background()
+
+	ap, apCleanup := createAgentPool(t, client)
+	defer apCleanup()
+
+	atTest, atTestCleanup := createAgentPoolToken(t, client, ap.ID)
+	defer atTestCleanup()
+
+	t.Run("when the token exists", func(t *testing.T) {
+		at, err := client.AccessTokens.Read(ctx, atTest.ID)
+		require.NoError(t, err)
+		assert.Equal(t, atTest.ID, at.ID)
+	})
+
+	t.Run("when the token does not exist", func(t *testing.T) {
+		_, err := client.AccessTokens.Read(ctx, "at-nonexisting")
+		assert.Error(t, err)
+	})
+
+	t.Run("with invalid token ID", func(t *testing.T) {
+		_, err := client.AccessTokens.Read(ctx, badIdentifier)
+		assert.EqualError(t, err, "invalid value for access token ID")
+	})
+}
+
 func TestAccessTokenUpdate(t *testing.T) {
 	client := testClient(t)
 	ctx := context.Background()